@noditlabs/nodit-mcp-server 1.0.2 → 1.0.4

package/README.md

@@ -2,6 +2,10 @@
 
 A Model Context Protocol (MCP) server that connects AI agents and developers to structured, context-ready blockchain data across multiple networks through Nodit's Web3 infrastructure.
 
+<a href="https://glama.ai/mcp/servers/@noditlabs/nodit-mcp-server">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@noditlabs/nodit-mcp-server/badge" alt="Nodit Server MCP server" />
+</a>
+
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue.svg)](https://www.typescriptlang.org/)
@@ -55,7 +59,7 @@ For detailed API specifications and usage guidelines, please refer to the [Nodit
   Query detailed Aptos blockchain activities through GraphQL endpoints.
 
 - **Supported Networks**  
-  - EVM-Compatible: Ethereum, Arbitrum, Avalanche, Base, Kaia, Optimism, Polygon
+  - EVM-Compatible: Ethereum, Arbitrum, Avalanche, Base, Chiliz, Kaia, Optimism, Polygon
   - Non-EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL
 
 
@@ -174,6 +178,47 @@ export NODIT_API_KEY=your-api-key
 claude
 ```
 
+## Example Prompts with Nodit MCP
+Once Nodit MCP is connected, you can use natural language to directly query blockchain data from multiple networks.
+The examples below illustrate just a few of the many possibilities — feel free to go beyond them and explore your own use cases. 
+
+### 📊 On-chain Activity Monitoring
+```
+Summarize the recent activity of 0xabc…def across Ethereum and Arbitrum. Include major transactions, token transfers, and NFT interactions over the past 7 days.
+```
+```
+What fungible and non-fungible tokens does this wallet hold across Ethereum and Polygon? Include balances and token names.
+```
+```
+Analyze the risk profile of wallet 0xabc… based on its recent on-chain behavior.
+```
+
+### 🧾 Smart Contract & Transaction Analysis
+```
+Analyze how users interacted with the contract at 0xcontract… on Ethereum over the last week.
+```
+```
+Analyze the last 10 blocks on Arbitrum.
+```
+
+### 🧠 AI Agent Use Cases
+```
+Based on wallet 0xabc…’s holdings, recommend optimal DeFi strategies across Ethereum and Arbitrum.
+```
+```
+Create a daily summary report for 0xdao… including token balances, inflow/outflow, and governance activity.
+```
+
+### ⚙️ Web3 DApp Development
+```
+Write TypeScript code using fetch to retrieve all ERC-20 transfers for 0xabc… from Ethereum using Nodit’s Node API.
+```
+```
+Build a simple dashboard to visualize how assets have moved in recent XRPL transactions.
+```
+```
+Build a dashboard that aggregates blockchain data across multiple chains using Nodit.
+```
 
 ## Scope & Limitations
 

package/build/spec/reference/arbitrum.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: arbitrum
-  version: 1.2.6
+  version: 1.2.7
 servers:
   - url: https://web3.nodit.io/v1
 components:
@@ -6469,6 +6469,12 @@ paths:
                           type: string
                           description: 출금한 수량을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.
                           pattern: ^[0-9]+$
+                  requestHash:
+                    type: string
+                    description: >-
+                      블록 헤더에 포함된 필드로, 해당 블록에 있는 모든 request들의 순서와 내용을 암호학적으로
+                      커밋(commit)한 해시값입니다. 이를 통해 전체 데이터를 다운로드하지 않아도 블록 내 request
+                      목록의 무결성을 검증할 수 있습니다.
                 example:
                   hash: >-
                     0x91c90676cab257a59cd956d7cb0bceb9b1a71d79755c23c7277a0697ccfaf8c4
@@ -8170,17 +8176,27 @@ paths:
                         pattern: ^0[xX][0-9a-fA-F]{40}$
                       type:
                         type: string
-                        description: >-
+                        description: >
                           트랜잭션의 타입을 나타내는 필드이며, 블록 시점에 따라 이 필드가 제공되지 않을 수 있습니다.
                           10진수 문자열 형태로 제공됩니다.
 
-                          0: Legacy transaction, EIP-1559 이전의 트랜잭션
+                          0: 이 값은 표준 이더리움 트랜잭션을 나타냅니다. 이는 EIP-2718 적용 이전의 전통적인
+                          트랜잭션 형식입니다.
+
+                          1: EIP-2930에서 도입된 'Access List' 트랜잭션을 나타냅니다. 이 유형의
+                          트랜잭션은 가스 비용을 최적화하기 위해 특정 주소와 저장소 슬롯에 대한 접근 목록을 포함합니다.
 
-                          1: Access List transaction, EIP-2930에 의해 도입된 접근 목록
-                          트랜잭션
+                          2: EIP-1559에서 도입된 'Fee Market' 트랜잭션을 나타냅니다. 이 유형의
+                          트랜잭션은 가변적인 가스 비용 모델을 사용하며, maxFeePerGas와
+                          maxPriorityFeePerGas 필드를 포함합니다.
 
-                          2: Fee market transaction, EIP-1559에 의해 도입된 수수료 시장
-                          트랜잭션
+                          3: EIP-4844에서 도입된 ‘Blob Transaction’을 나타냅니다. 이 유형의
+                          트랜잭션은 본문과 별도로 추가적인 blob 데이터를 포함하며, 롤업(Rollup) 등 Layer2
+                          솔루션과 연계하여 데이터 가용성을 개선하고 확장성을 지원합니다.
+
+                          4: EIP-7702에서 도입된 확장된 트랜잭션 유형으로, 서명/승인 정보를 담은
+                          authorizationList 필드를 포함합니다. 이 필드는 다중 서명 또는 추가 인증 절차가
+                          필요한 경우 사용됩니다.
                         pattern: ^[0-9]+$
                       status:
                         type: string
@@ -8222,6 +8238,44 @@ paths:
                       timeStamp:
                         type: integer
                         description: 트랜잭션이 생성된 시간을 나타내는 필드입니다. 이 필드는 UNIX 타임스탬프로 제공됩니다.
+                      authorizationList:
+                        type: array
+                        description: >-
+                          이 필드는 트랜잭션의 서명 및 승인 정보를 담은 목록입니다. 각 항목은 서명 검증에 필요한 체인
+                          ID, nonce, 서명값 등을 포함하며, EIP-7702 적용 이후부터 제공됩니다. 네트워크에
+                          따라 지원 여부와 적용 시점이 달라질 수 있으며, 특정 트랜잭션 타입(예: type이 4
+                          이상)에서만 사용되므로 트랜잭션 유형에 따라 해당 필드가 없을 수도 있습니다.
+                        items:
+                          type: object
+                          properties:
+                            chainId:
+                              type: string
+                              description: >-
+                                해당 승인 정보가 유효한 체인의 ID를 나타내며, 서명 검증 및 리플레이 공격 방지에
+                                활용됩니다. 이 필드는 10진수 문자열 형태로 표현합니다.
+                            nonce:
+                              type: string
+                              description: >-
+                                이 승인 항목의 고유성을 보장하고, 리플레이 공격을 방지하기 위한 nonce 값입니다.
+                                이 필드는 10진수 문자열 형태로 표현합니다.
+                            address:
+                              type: string
+                              description: 승인(서명)을 제공하는 계정의 주소입니다.
+                            yParity:
+                              type: string
+                              description: >-
+                                서명된 공개키의 y좌표 선택을 위한 1비트 패리티 값입니다. 보통 0 또는 1이며,
+                                공개키 복원에 사용됩니다. 이 필드는 10진수 문자열 형태로 표현합니다.
+                            r:
+                              type: string
+                              description: >-
+                                ECDSA 서명의 첫 번째 값으로, 서명에 사용된 난수와 곡선 연산을 통해 생성됩니다.
+                                공개키 복원 및 서명 검증에 사용됩니다.
+                            s:
+                              type: string
+                              description: >-
+                                ECDSA 서명의 두 번째 값으로, 메시지 해시와 개인 키를 기반으로 계산됩니다.
+                                서명의 유효성을 검증하는 데 필수입니다.
                   - type: object
                     properties:
                       logs:
@@ -10923,17 +10977,6 @@ paths:
       description: >+
         특정 주소의 통계 정보를 조회합니다. 계정 주소의 트랜잭션, 전송 이벤트, 자산 등의 정보를 통해서 계정의 활동을 분석할 수
         있습니다.
-            
-
-        > 🚧 Internal Transaction Count에 null이 표기되나요?
-
-        >
-
-        > transactionCounts.internal 필드는 Ethereum Mainnet, Arbitrum Mainnet,
-        Base Mainnet, Kaia Mainnet, TheBalance Mainnet에서만 지원됩니다. 그 외에 다른 네트워크에서는
-        null로 표기됩니다.
-
-
 
       summary: Get Account Stats
       operationId: arbitrum-getAccountStats

package/build/spec/reference/base.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: base
-  version: 1.2.6
+  version: 1.2.7
 servers:
   - url: https://web3.nodit.io/v1
 components:
@@ -6469,6 +6469,12 @@ paths:
                           type: string
                           description: 출금한 수량을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.
                           pattern: ^[0-9]+$
+                  requestHash:
+                    type: string
+                    description: >-
+                      블록 헤더에 포함된 필드로, 해당 블록에 있는 모든 request들의 순서와 내용을 암호학적으로
+                      커밋(commit)한 해시값입니다. 이를 통해 전체 데이터를 다운로드하지 않아도 블록 내 request
+                      목록의 무결성을 검증할 수 있습니다.
                 example:
                   hash: >-
                     0x91c90676cab257a59cd956d7cb0bceb9b1a71d79755c23c7277a0697ccfaf8c4
@@ -8170,17 +8176,27 @@ paths:
                         pattern: ^0[xX][0-9a-fA-F]{40}$
                       type:
                         type: string
-                        description: >-
+                        description: >
                           트랜잭션의 타입을 나타내는 필드이며, 블록 시점에 따라 이 필드가 제공되지 않을 수 있습니다.
                           10진수 문자열 형태로 제공됩니다.
 
-                          0: Legacy transaction, EIP-1559 이전의 트랜잭션
+                          0: 이 값은 표준 이더리움 트랜잭션을 나타냅니다. 이는 EIP-2718 적용 이전의 전통적인
+                          트랜잭션 형식입니다.
+
+                          1: EIP-2930에서 도입된 'Access List' 트랜잭션을 나타냅니다. 이 유형의
+                          트랜잭션은 가스 비용을 최적화하기 위해 특정 주소와 저장소 슬롯에 대한 접근 목록을 포함합니다.
 
-                          1: Access List transaction, EIP-2930에 의해 도입된 접근 목록
-                          트랜잭션
+                          2: EIP-1559에서 도입된 'Fee Market' 트랜잭션을 나타냅니다. 이 유형의
+                          트랜잭션은 가변적인 가스 비용 모델을 사용하며, maxFeePerGas와
+                          maxPriorityFeePerGas 필드를 포함합니다.
 
-                          2: Fee market transaction, EIP-1559에 의해 도입된 수수료 시장
-                          트랜잭션
+                          3: EIP-4844에서 도입된 ‘Blob Transaction’을 나타냅니다. 이 유형의
+                          트랜잭션은 본문과 별도로 추가적인 blob 데이터를 포함하며, 롤업(Rollup) 등 Layer2
+                          솔루션과 연계하여 데이터 가용성을 개선하고 확장성을 지원합니다.
+
+                          4: EIP-7702에서 도입된 확장된 트랜잭션 유형으로, 서명/승인 정보를 담은
+                          authorizationList 필드를 포함합니다. 이 필드는 다중 서명 또는 추가 인증 절차가
+                          필요한 경우 사용됩니다.
                         pattern: ^[0-9]+$
                       status:
                         type: string
@@ -8222,6 +8238,44 @@ paths:
                       timeStamp:
                         type: integer
                         description: 트랜잭션이 생성된 시간을 나타내는 필드입니다. 이 필드는 UNIX 타임스탬프로 제공됩니다.
+                      authorizationList:
+                        type: array
+                        description: >-
+                          이 필드는 트랜잭션의 서명 및 승인 정보를 담은 목록입니다. 각 항목은 서명 검증에 필요한 체인
+                          ID, nonce, 서명값 등을 포함하며, EIP-7702 적용 이후부터 제공됩니다. 네트워크에
+                          따라 지원 여부와 적용 시점이 달라질 수 있으며, 특정 트랜잭션 타입(예: type이 4
+                          이상)에서만 사용되므로 트랜잭션 유형에 따라 해당 필드가 없을 수도 있습니다.
+                        items:
+                          type: object
+                          properties:
+                            chainId:
+                              type: string
+                              description: >-
+                                해당 승인 정보가 유효한 체인의 ID를 나타내며, 서명 검증 및 리플레이 공격 방지에
+                                활용됩니다. 이 필드는 10진수 문자열 형태로 표현합니다.
+                            nonce:
+                              type: string
+                              description: >-
+                                이 승인 항목의 고유성을 보장하고, 리플레이 공격을 방지하기 위한 nonce 값입니다.
+                                이 필드는 10진수 문자열 형태로 표현합니다.
+                            address:
+                              type: string
+                              description: 승인(서명)을 제공하는 계정의 주소입니다.
+                            yParity:
+                              type: string
+                              description: >-
+                                서명된 공개키의 y좌표 선택을 위한 1비트 패리티 값입니다. 보통 0 또는 1이며,
+                                공개키 복원에 사용됩니다. 이 필드는 10진수 문자열 형태로 표현합니다.
+                            r:
+                              type: string
+                              description: >-
+                                ECDSA 서명의 첫 번째 값으로, 서명에 사용된 난수와 곡선 연산을 통해 생성됩니다.
+                                공개키 복원 및 서명 검증에 사용됩니다.
+                            s:
+                              type: string
+                              description: >-
+                                ECDSA 서명의 두 번째 값으로, 메시지 해시와 개인 키를 기반으로 계산됩니다.
+                                서명의 유효성을 검증하는 데 필수입니다.
                   - type: object
                     properties:
                       logs:
@@ -10923,17 +10977,6 @@ paths:
       description: >+
         특정 주소의 통계 정보를 조회합니다. 계정 주소의 트랜잭션, 전송 이벤트, 자산 등의 정보를 통해서 계정의 활동을 분석할 수
         있습니다.
-            
-
-        > 🚧 Internal Transaction Count에 null이 표기되나요?
-
-        >
-
-        > transactionCounts.internal 필드는 Ethereum Mainnet, Arbitrum Mainnet,
-        Base Mainnet, Kaia Mainnet, TheBalance Mainnet에서만 지원됩니다. 그 외에 다른 네트워크에서는
-        null로 표기됩니다.
-
-
 
       summary: Get Account Stats
       operationId: base-getAccountStats

package/build/spec/reference/bitcoin.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: bitcoin
-  version: 1.2.6
+  version: 1.2.8
 servers:
   - url: https://web3.nodit.io/v1
 components:
@@ -313,7 +313,7 @@ paths:
                       default: '2025-01-31T00:00:00+00:00'
                   required:
                     - accountAddress
-                - &ref_14
+                - &ref_11
                   type: object
                   properties:
                     page:
@@ -1031,7 +1031,7 @@ paths:
                 type: array
                 items:
                   allOf:
-                    - &ref_11
+                    - &ref_12
                       type: object
                       required:
                         - id
@@ -1121,7 +1121,7 @@ paths:
                           example: 1716177005
                     - type: object
                       properties:
-                        vin: &ref_12
+                        vin: &ref_13
                           type: object
                           required:
                             - index
@@ -1209,7 +1209,7 @@ paths:
                               items:
                                 type: string
                                 example: 3045022100b228e33e8b62f825...
-                        vout: &ref_13
+                        vout: &ref_14
                           type: object
                           required:
                             - index
@@ -1349,23 +1349,26 @@ paths:
             schema:
               additionalProperties: false
               type: object
-              properties:
-                accountAddress:
-                  type: string
-                  description: >-
-                    조회하고자 하는 계정의 주소를 지정하는 파라미터입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로
-                    입력할 수 있습니다.
-                  pattern: >-
-                    ^(1[a-km-zA-HJ-NP-Z1-9]{25,33}|3[a-km-zA-HJ-NP-Z1-9]{25,33}|bc1q[a-z0-9]{38,59}|bc1p[a-z0-9]{58})$
-                  example: bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq
-                  default: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
-                relation: *ref_6
-                fromBlock: *ref_7
-                toBlock: *ref_8
-                fromDate: *ref_9
-                toDate: *ref_10
-              required:
-                - accountAddress
+              allOf:
+                - type: object
+                  properties:
+                    accountAddress:
+                      type: string
+                      description: >-
+                        조회하고자 하는 계정의 주소를 지정하는 파라미터입니다. 0x로 시작하는 40자리의 16진수 문자열
+                        형태로 입력할 수 있습니다.
+                      pattern: >-
+                        ^(1[a-km-zA-HJ-NP-Z1-9]{25,33}|3[a-km-zA-HJ-NP-Z1-9]{25,33}|bc1q[a-z0-9]{38,59}|bc1p[a-z0-9]{58})$
+                      example: bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq
+                      default: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
+                    relation: *ref_6
+                    fromBlock: *ref_7
+                    toBlock: *ref_8
+                    fromDate: *ref_9
+                    toDate: *ref_10
+                  required:
+                    - accountAddress
+                - *ref_11
       responses:
         '200':
           description: Successful Response
@@ -1399,11 +1402,11 @@ paths:
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
                     items:
                       allOf:
-                        - *ref_11
+                        - *ref_12
                         - type: object
                           properties:
-                            vin: *ref_12
-                            vout: *ref_13
+                            vin: *ref_13
+                            vout: *ref_14
               example:
                 rpp: 10
                 page: 1
@@ -1582,11 +1585,11 @@ paths:
                 type: array
                 items:
                   allOf:
-                    - *ref_11
+                    - *ref_12
                     - type: object
                       properties:
-                        vin: *ref_12
-                        vout: *ref_13
+                        vin: *ref_13
+                        vout: *ref_14
         '400': *ref_1
         '401': *ref_2
         '403': *ref_3
@@ -1642,7 +1645,7 @@ paths:
                       default: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
                   required:
                     - accountAddress
-                - *ref_14
+                - *ref_11
       responses:
         '200':
           description: Successful Response