Nooscape MCP server

nooscape-mcp

An MCP server for Nooscape. It lets an AI assistant, or an agent, ask what is on record about an agent, a wallet or an endpoint before it pays or relies on it.

It is a thin, read-only client of the public Nooscape API (https://nooscape.si/api/v1). It adds no data and no logic of its own. Every answer says when it was read, where it came from and what the evidence level is.

What it gives you

Four tools, all read-only. Each returns a short plain summary first, then the API's JSON exactly as it was given.

Chains are robinhood (Robinhood Chain), bnb (BNB Smart Chain), solana, base (Base) and arc (Arc). An agent's id on robinhood, bnb, base and arc is its token id (digits). For Solana, an address can be listed by more than one registry: both agent tools take an optional registry (solana8004, solanasaid or solana_registry) to choose.

check takes exactly one of agent ({ chain, id }), wallet or url. A url can be a full address or a bare host such as example.com; it is matched by its host alone and nothing is fetched from it. chain can narrow a wallet or url.

Install

Node.js 18 or later. Nothing to build: npx fetches it.

Claude Desktop

Add this to claudedesktopconfig.json (Settings, Developer, Edit Config), then restart Claude Desktop:

{
  "mcpServers": {
    "nooscape": {
      "command": "npx",
      "args": ["-y", "nooscape-mcp"],
      "env": { "NOOSCAPE_API_KEY": "nsk_your_key_here" }
    }
  }
}

Leave out the env block to use it with no key. Lookups and search work without one.

Cursor

Add the same block to ~/.cursor/mcp.json (or to .cursor/mcp.json in a project):

{
  "mcpServers": {
    "nooscape": {
      "command": "npx",
      "args": ["-y", "nooscape-mcp"],
      "env": { "NOOSCAPE_API_KEY": "nsk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add nooscape --env NOOSCAPE_API_KEY=nsk_your_key_here -- npx -y nooscape-mcp

Any other MCP client

Run npx -y nooscape-mcp as a stdio server.

Environment

Keys, limits and payment

• No key: searchagents and getagent work, at 30 requests a minute from one address.
• A free key raises that to 60 a minute and 1,000 a day, and opens getagenthistory.
• check needs a Pro key, or an x402 payment (currently $0.01 per call, in USDC on Arc). This server holds no wallet and does not sign or send payments. Without a Pro key, check returns a clear message with the price and the terms the API asked for, and nothing is charged. An x402-capable client can pay the API directly; paying from inside this server may come later.
• A refused request is not retried. On a rate limit the message says how many seconds to wait (the API's Retry-After).
• Requests time out after 15 seconds.

Example prompts

Shortened. The full README is on GitHub.