TollNode

AI models plus live data from LinkedIn, Google, YouTube, TikTok, Amazon and more. Pay per call.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
86%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,821Tokens (tool definitions)
~1.0 KBTypical response size
Moderate attention impact (1.42% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "tollnode": {
      "url": "https://tollnode.com/mcp"
    }
  }
}

Remote endpoints

https://tollnode.com/mcpstreamable-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_tools(query, category, limit)

Free; reads only. Finds the TollNode tools for a task and returns each match's name, title, one-line purpose, category and price per call, best matches first. Use it first whenever you need a capability (make an image or video, a voice or song, read a web page, search Google or Maps, get LinkedIn, YouTube, Amazon or other platform data, check a domain, weather or public data). Then call get_tool with the name you pick, then run_tool. With no query it lists everything in the category, or the whole catalog.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "The task, model or platform in plain words, e.g. 'remove background', 'video with sound', 'linkedin company', 'gpt image'. Leave out to list all."
    },
    "category": {
      "type": "string",
      "description": "Only this category, e.g. Image, Video, Audio, Search, Social, Shopping, Business, Travel, Lookup, Document."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Most results to return, 1 to 50. Default 20"
    }
  },
  "additionalProperties": false
}
🟢get_tool(name)

Free; reads only. Returns everything needed to run one tool: what it does, when to use it and when not, its full JSON input schema with limits, its price per call and price options, its actions (for platform tools such as linkedin or google), an example input and its web page. Call it after search_tools and before run_tool so the input is right the first time.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The tool's name from search_tools, e.g. 'gpt-image-2-5-sunburst', 'linkedin' or 'weather'."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
🟡run_tool(name, input, idempotency_key)

Runs one TollNode tool and returns its result: text, data, or links to the files it made. Spends money: the tool's price (see get_tool) is charged only when the call returns a usable result; a refused input, a failure or an empty result costs nothing. Every successful call is charged again, so do not repeat one that worked; send idempotency_key to make a retry safe. Pay from an account balance (API key on the connection) or with x402: the first call answers with the payment requirements as an error result; sign them and call again with the payment in params._meta["x402/payment"]. Account results end with the amount charged and a request id for get_call. The whole request is capped at 4.5 MB: send photos, audio and video as https links, or call upload_file first for anything over about 3 MB and pass its fileUrl.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The tool's name from search_tools, e.g. 'weather'."
    },
    "input": {
      "type": "object",
      "description": "The tool's input fields, exactly as get_tool's inputSchema describes them, e.g. {\"action\": \"current\", \"location\": \"Lisbon\"}."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional, any unique text. Repeating an account call with the same key returns the first result without charging again."
    }
  },
  "required": [
    "name",
    "input"
  ],
  "additionalProperties": false
}
🟢get_call(request_id)

Free; reads only. Looks up one of your earlier account calls by its request id (given after every charged run_tool result and in errors): whether it is running, succeeded or failed, what it was charged, and its result again. Use it to recover a result after a dropped connection instead of paying twice: a call can't be cancelled and keeps running to the end even if you disconnect. list_calls finds request ids. Needs an account API key on the connection; x402 calls are not looked up here.

Input Schema

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$",
      "description": "The request id, a UUID such as 3f2b6c1e-8d4a-4f7e-9a1b-2c3d4e5f6a7b."
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}
🟢list_calls(limit, status, before)

Free; reads only. Lists your recent account calls, newest first: the tool, whether it succeeded, failed or is still running, what it was charged (failed calls cost $0) and its request id, plus the total charged on the page. Use it to review spending or find a request id for get_call. Filter by status, page back with before (the next value from the previous page). Needs an account API key on the connection; x402 calls are paid from your own wallet and show in its history instead.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many calls to return, 1 to 50. Default 20."
    },
    "status": {
      "type": "string",
      "enum": [
        "succeeded",
        "failed",
        "running"
      ],
      "description": "Only calls with this status. Leave out for all."
    },
    "before": {
      "type": "string",
      "description": "Only calls made before this time (ISO 8601). Use the createdAt of the last call on the previous page."
    }
  },
  "additionalProperties": false
}
🟡upload_file(content_type, filename)

Free. A tool request is capped at 4.5 MB in total, and inline base64 files count toward it (base64 adds a third). For a bigger file, or any local file you would rather not inline (a long voice track, a full-size photo, a video), call this first: it returns a one-time uploadUrl and the fileUrl the file will have. PUT the file's raw bytes to uploadUrl within 15 minutes with the returned content-type header (the response includes a ready curl command; up to 100 MB), then pass fileUrl in the tool's file field (for example image or audio) with run_tool. One file per link. The file is deleted once a call that used it succeeds, so upload again for each new call; if no call succeeds with it, it is deleted after 6 hours.

Input Schema

{
  "type": "object",
  "properties": {
    "content_type": {
      "type": "string",
      "description": "The file's media type: image/jpeg, image/png, image/webp, image/gif, audio/mpeg, audio/wav, audio/flac, audio/ogg, audio/mp4, video/mp4, video/webm, video/quicktime or application/pdf."
    },
    "filename": {
      "type": "string",
      "description": "Optional instead of content_type: the file's name, e.g. 'voice.mp3'; its extension sets the type."
    }
  },
  "additionalProperties": false
}
🟢get_balance

Free; reads only. Returns your prepaid account balance in US dollars, so you can check a batch is affordable before running it. Needs an account API key on the connection (Authorization: Bearer tn_live_…). With x402 there is no balance: each call is paid from your own wallet.

Input Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools