Teckel Ethereum Toolkit

ethereum toolkit

この MCP サーバーは、teckel の Web3 Ethereum JSON-RPC サービスの一部、つまりブロックチェーン（Mainnet と Sepolia）への読み取り専用アクセスを必要とするサービスを利用できるようにします。

ethereum toolkit の主な目的は、LLM／AI／エージェントに Ethereum ブロックチェーンの基本情報へのリアルタイムアクセスを提供することです。お好みの MCP クライアントを介して LLM に接続すると、LLM はツールキットの一連のツールを使用して、次のようなプロンプトに回答できます。

「Mainnet と Sepolia テストネットにおける現在の Ethereum 価格（USD）はいくらですか？」

「Mainnet と Sepolia テストネットにおける現在の Ethereum のガス価格はいくらですか？」

「Mainnet と Sepolia テストネットにおける自分の Ethereum アカウントの残高はいくらですか？」

「Mainnet と Sepolia テストネットの最新ブロックで、どのトランザクションが処理されましたか？」

teckel ツールキットの使用方法

まず、teckel アプリをダウンロードしてインストールします。

次に、teckel アプリを使って API キーを生成します。

次の手順を行います。

1. アプリのホーム画面右上にあるウォレットアイコンをタップして、Accounts ページに移動します。Accounts ページで「Manage API Key」をタップし、作成済みまたはインポート済みの Ethereum アカウントの API キーマネージャーにアクセスします。

2. エンドポイントへのリクエスト時に API キーを使用します。利用可能なすべてのエンドポイントは teckel アプリから利用でき、対象の Ethereum アカウントの実際の API キーが含まれています。

3. 以下の例では、説明のために次の架空のキーを使用します：d1e12345-c234-45a6-9b76-1234567891ff。この架空のキーの代わりに、ご自身の API キーを使用してください。

次に、MCP サーバーと RESTful（API）のどちらを使用してツールにアクセスするかを決めます。

MCP サーバーの使用

お好みの MCP クライアントを設定する

クライアントにかかわらず、設定は基本的に同じです。つまり、MCP サーバーのエンドポイントとアクセス認証情報をクライアントに指定します。通常は設定用の JSON スニペットを使用し、「Authorization」タグの「Bearer」トークンとして API キーを指定します。例として、Cursor デスクトップアプリで使用する正確な設定を以下に示します（Cursor アプリで Cursor Settings -> Tools & MCP -> + New MCP server に移動し、架空のキーを実際の teckel API キーに置き換えて詳細を入力してください）。

MCP JSON 設定（Cursor で使用する例）

{
 "mcpServers": {    
    "teckel-ethereum-toolkit": {
      "url": "https://mcp-servers.bh.tkllabs.io:9780/ethereum-mcp",
      "headers": {
        "Authorization": "Bearer d1e12345-c234-45a6-9b76-1234567891ff"
      }
    }   
  }
}

注：この設定は HTTP（streamable）プロトコルを前提としています。クライアントが旧式（現在はレガシー）の SSE プロトコルを必要とする場合は、「ethereum-mcp」を「ethereum-sse」に置き換えてください。

MCP JSON 設定（n8n で使用する例）

同様に、n8n で使用する場合は、teckel Ethereum Toolkit および Navigation Toolkits MCP サーバーにアクセスするサンプルワークフローの JSON コードスニペットを以下に示します。（このスニペット全体を .json ファイルに保存し、そのファイルを n8n ワークフローにインポートします。）n8n で独自の「Bearer Auth」認証情報を設定し、認証情報をご自身のものに置き換える必要があります（teckel API キーを「Bearer token」として使用します）。

{
  "name": "Teckel Tools MCP Example",
  "nodes": [
    {
      "parameters": {
        "endpointUrl": "https://mcp-servers.bh.tkllabs.io:9780/ethereum-mcp",
        "authentication": "bearerAuth",
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.mcpClientTool",
      "typeVersion": 1.2,
      "position": [
        -16,
        640
      ],
      "id": "569bf922-b8cb-40a0-beb8-2da890dab925",
      "name": "Teckel Tools MCP server: ethereum",
      "credentials": {
        "httpBearerAuth": {
          "id": "zPHt516IS5uuS2S5",
          "name": "TECKEL APIKEY"
        }
      }
    },
    {
      "parameters": {
        "modelId": {
          "__rl": true,
          "value": "gpt-5",
          "mode": "list",
          "cachedResultName": "GPT-5"
        },
        "messages": {
          "values": [
            {
              "content": "Perform a VFR flight route calculation from EGNS to EGPK, departing 60 minutes from now. Include an intermediate waypoint on magnetic bearing 320 degrees at 20 nm from EGNS, followed by another on true bearing 355 for 15 nm from the previous waypoint.\n"
            }
          ]
        },
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.openAi",
      "typeVersion": 1.8,
      "position": [
        -496,
        368
      ],
      "id": "5c9a94cd-71a4-4d77-84f5-664ef14871af",
      "name": "Message a model",
      "credentials": {
        "openAiApi": {
          "id": "EvoF3L2GoYTtESR3",
          "name": "OpenAi account"
        }
      }
    },
    {
      "parameters": {
        "endpointUrl": "https://mcp-servers.bh.tkllabs.io:9780/navigation-mcp",
        "authentication": "bearerAuth",
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.mcpClientTool",
      "typeVersion": 1.2,
      "position": [
        192,
        640
      ],
      "id": "016dae90-92b4-4eed-9120-f8531bafbd10",
      "name": "Teckel Tools MCP server: navigation",
      "credentials": {
        "httpBearerAuth": {
          "id": "zPHt516IS5uuS2S5",
          "name": "TECKEL APIKEY"
        }
      }
    }
  ],
  "pinData": {},
  "connections": {
    "Teckel Tools MCP server: ethereum": {
      "ai_tool": [
        [
          {
            "node": "Message a model",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    },
    "Teckel Tools MCP server: navigation": {
      "ai_tool": [
        [
          {
            "node": "Message a model",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    }
  },
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "626e0784-a43b-4857-bf54-91e7f1c32c59",
  "meta": {
    "templateId": "self-building-ai-agent",
    "templateCredsSetupCompleted": true,
    "instanceId": "3c7702199c1f42229c256ae3782d70f8576bc5028e557d0903826477f97e032b"
  },
  "id": "rAm1XjSle8lYmOcT",
  "tags": []
}

RESTful API サーバーの使用

MCP サーバーを使用する利点は、接続された LLM がユーザープロンプトの自然言語を解析し、ツールボックス API 関数を呼び出すために必要なパラメーターを設定して、返された JSON 構造を同様に自然言語に変換し、ユーザーに提示できることです。ただし、teckel ツールキットをより低いレベルで（たとえば、ご自身のアプリ内で）利用したい場合は、RESTful（POST）API プロトコルを使用して関数を直接呼び出せます。その場合、入力パラメーターの設定と、返された JSON 出力の処理はご自身で行う必要があります。

ベース API URL エンドポイントは MCP サーバーのエンドポイントと同じです。

https://mcp-servers.bh.tkllabs.io:9780/

この URL に目的の関数名を追加し、関数の引数をクエリー文字列パラメーターとして追加します。teckel API キーは、Authorization ヘッダーに Bearer Token として追加する必要があります。GET ではなく POST プロトコルを使用する必要がありますが、パラメーターはクエリー文字列で渡すため、本文は空で構いません。以下は、必要なネットワークパラメーターを指定して、Ethereum Toolkit の eth_gasPrice メソッドから perform_sun_calculations を呼び出す curl リクエストの例です。

Curl リクエスト

curl -X POST \   'https://mcp-servers.bh.tkllabs.io:9780/eth_gasPrice?network=mainnet' \
  -H 'Authorization: Bearer d1e12345-c234-45a6-9b76-1234567891ff' \
  -H 'Content-Type: application/json'

JSON レスポンス

{"gas_price":465912773}

関数（ツール）一覧

ツールキットで利用できる関数の全一覧は、https://teckel.io/ai-mcp-services/ で確認できます。

料金

ツールキット内の各関数の利用料金（teckel App 内で購入する teckel credits を使用）は、https://teckel.io/ai-mcp-services/ で確認できます。

レート制限

すべての MCP/API 呼び出しには、API キーごとのレート制限が適用されます。しきい値は公開されていませんが、API キーがレート制限を超過した場合、該当する呼び出しに対して 429 エラーコードが返されます。

エラー

ユーザーエラーによって MCP/API 呼び出しが失敗し、4xx エラーコードが返された場合、ユーザーには Base Call Fee 1 回分が請求されます（https://teckel.io/ai-mcp-services/ を参照）。サーバーエラーによって API 呼び出しが失敗し、5xx エラーコードが返された場合、ユーザーには請求されません。該当する呼び出しがネストされた呼び出しの連鎖の一部である場合、上記のルールは「外側」の呼び出しに適用されます。つまり、外側の呼び出しが 4xx エラーコードで失敗した場合、ユーザーには Base Call Fee 1 回分（失敗した外側の呼び出し分）が請求され、連鎖内の呼び出し（成功したかどうかを問わず）には請求されません。同様に、外側の呼び出しが 5xx エラーコードで失敗した場合、連鎖内の呼び出しが成功していても、ユーザーには一切請求されません。

API キーのセキュリティに関する注意

API キーが漏えいした可能性があり（他者がキーを使用して teckel credits を消費している可能性がある）と懸念される場合は、teckel App の API Key Manager → Replace API key からキーを交換してください。古いキーは直ちに無効になります。