Nooscape MCPとは
AIエージェント、仮想通貨ウォレット、およびエンドポイントに関する読み取り専用の公開記録をAIアシスタントが照会し、やり取りを行う前に履歴や所有権を確認できます。
プロジェクトのREADMEから生成された概要
Nooscape MCP server について
nooscape-mcpは、AIエージェント、仮想通貨ウォレット、およびエンドポイントの履歴と所有権の検証を、開発者やAIエージェントに提供します。Nooscape APIの読み取り専用クライアントとして機能するこのサーバーは、Ethereum、Solana、Base、BNB Smart Chain、Monad、Arc、Robinhood Chainを含む複数のブロックチェーンにわたる公開記録から、事実に基づいたデータを提供します。これにより、AIアシスタントはトランザクションが発生する前に、ウォレットやURLの事前チェックを行い、記録された所有権の変更やエビデンスレベルを確認できます。
ユーザーはnpxを使用してサーバーをローカルで実行するか、Claude Desktop、Cursor、Claude Codeなどのクライアントに接続できます。基本的な検索やエージェントの照会は認証なしでも可能ですが、無料のAPIキーを使用するとレート制限が緩和され、エージェントの履歴へのアクセスが可能になります。checkツールを介してより詳細な事前チェックの事実を取得するには、Proキーまたはx402の支払いが必要です。このサーバーは、正確なJSONデータとともに簡潔なサマリーを返す軽量なレイヤーとして設計されており、すべての情報にソースとエビデンスレベルが含まれるようになっています。
できること
- 1エージェントの登録詳細の検証AIアシスタントは、Robinhood Chain上の特定のエージェントが最初に確認された時期を調べ、その登録者を特定できます。
- 2ウォレットの事前チェックの実行開発者はAIに対し、資金を送金する前にウォレットの履歴や所有権の変更を調査するよう依頼できます。
- 3エージェントレジストリイベントの監査特定のエージェントIDに関する、クレームやレジストリイベントの公開履歴を取得できます。
- 4ディレクトリ統計のモニタリングAIは、さまざまなチェーンにいくつのエントリがリストされているか、およびそれらが最後にインデックスされた時期について報告できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Nooscape MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにNooscape MCPをインストール
$ claude mcp add --env 'NOOSCAPE_API_KEY=<YOUR_NOOSCAPE_API_KEY>' nooscape-mcp -- npx -y nooscape-mcpCursorにNooscape MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"nooscape-mcp": {
"command": "npx",
"args": [
"-y",
"nooscape-mcp"
],
"env": {
"NOOSCAPE_API_KEY": "<YOUR_NOOSCAPE_API_KEY>"
}
}
}
}VS CodeにNooscape MCPをインストール
.vscode/mcp.json
{
"servers": {
"nooscape-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"nooscape-mcp"
],
"env": {
"NOOSCAPE_API_KEY": "<YOUR_NOOSCAPE_API_KEY>"
}
}
}
}VS Code CLIにNooscape MCPをインストール
$ code --add-mcp '{"name":"nooscape-mcp","type":"stdio","command":"npx","args":["-y","nooscape-mcp"],"env":{"NOOSCAPE_API_KEY":"<YOUR_NOOSCAPE_API_KEY>"}}'Claude DesktopにNooscape MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"nooscape-mcp": {
"command": "npx",
"args": [
"-y",
"nooscape-mcp"
],
"env": {
"NOOSCAPE_API_KEY": "<YOUR_NOOSCAPE_API_KEY>"
}
}
}
}CodexにNooscape MCPをインストール
$ codex mcp add nooscape-mcp --env 'NOOSCAPE_API_KEY=<YOUR_NOOSCAPE_API_KEY>' -- npx -y nooscape-mcpCodex config.tomlにNooscape MCPをインストール
~/.codex/config.toml
[mcp_servers.nooscape-mcp] command = "npx" args = ["-y", "nooscape-mcp"] [mcp_servers.nooscape-mcp.env] NOOSCAPE_API_KEY = "<YOUR_NOOSCAPE_API_KEY>"
Gemini CLIにNooscape MCPをインストール
$ gemini mcp add -s user -e 'NOOSCAPE_API_KEY=<YOUR_NOOSCAPE_API_KEY>' nooscape-mcp npx -- -y nooscape-mcpGemini settings.jsonにNooscape MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"nooscape-mcp": {
"command": "npx",
"args": [
"-y",
"nooscape-mcp"
],
"env": {
"NOOSCAPE_API_KEY": "<YOUR_NOOSCAPE_API_KEY>"
}
}
}
}設定
NOOSCAPE_API_KEYシークレットOptional. A Nooscape API key, sent as a bearer token. A free key opens the agent history; the pre-flight check needs a Pro key. Make one at https://nooscape.si/developers/keys.
| 名前 | 説明 | 種類 |
|---|---|---|
| NOOSCAPE_API_KEY | Optional. A Nooscape API key, sent as a bearer token. A free key opens the agent history; the pre-flight check needs a Pro key. Make one at https://nooscape.si/developers/keys. | シークレット |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能runtimeadmin/nooscape-mcp is public and reachablegithub.com/runtimeadmin/nooscape-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定nooscape-mcp names runtimeadmin/nooscape-mcp as sourcenpmjs.com/package/nooscape-mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-02github.com/runtimeadmin/nooscape-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from nooscape-mcp合格
- パッケージおよびその依存関係に重大な勧告なし99 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る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
Five tools, all read-only. Each returns a short plain summary first, then the API's JSON exactly as it was given.
| Tool | What it does | Needs |
|---|---|---|
search_agents(query, chain?) |
Search listed agents by name, endpoint host, registry key or wallet. | nothing |
get_stats() |
What the directory holds on each chain it reads: the entries it lists and the registries behind them, the ratings recorded on chain where they are counted, the entries first seen in the last 24 hours, and when each chain was last read. A chain Nooscape does not read is reported as not indexed, which is not zero. | nothing |
get_agent(chain, id) |
One agent's record: first and last seen, who registered it, evidence level, listings that share its wallet, registry activity, ratings, and any claim by its owner. | nothing |
get_agent_history(chain, id) |
One agent's registry events and the public history of claims on it. | an API key (a free one is enough) |
check(agent | wallet | url) |
Pre-flight facts: when each listing was first seen, recorded ownership changes, the share of ratings that were revoked, how many listings its wallet registered, and the evidence level. | a Pro key, or an x402 payment (see below) |
Chains are robinhood (Robinhood Chain), bnb (BNB Smart Chain), solana, ethereum (Ethereum), base (Base), arc (Arc) and monad (Monad). An agent's id on robinhood, bnb, ethereum, base, arc and monad is its token id (digits). For Solana, an address can be listed by more than one registry: both agent tools take an optional registry (solana_8004, solana_said, solana_registry or solana_agenc) 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. npx -y nooscape-mcp runs the latest release every time it starts. To stay on one release, name it, as in nooscape-mcp@0.6.0.
Claude Desktop
Add this to claude_desktop_config.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
| Variable | What it is |
|---|---|
NOOSCAPE_API_KEY |
Optional. An API key, sent as Authorization: Bearer. A free key is made at nooscape.si/developers/keys. It is never logged, never echoed and never put in a result or an error. |
NOOSCAPE_MCP_TOKEN |
Optional, and only for --http. A shared secret of at least 24 characters. Required with --allow-remote; whenever it is set, every caller must send it as Authorization: Bearer <secret>. It is never logged or echoed. |
Keys, limits and payment
- No key:
search_agents,get_agentandget_statswork, at 30 requests a minute from one address. - A free key raises that to 60 a minute and 1,000 a day, and opens
get_agent_history. checkneeds a Pro key, or an x402 payment (currently $0.01 per call, in USDC on Base or Arc). This server holds no wallet and does not sign or send payments. Without a Pro key,checkreturns 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
- "Look up Robinhood Chain agent 8865 on Nooscape. When was it first seen, and who registered it?"
- "Search Nooscape for agents on the host
example.com." - "Before I pay this wallet, what does Nooscape have on record about it?" (uses
check) - "Show me the registry events and claim history for Robinhood Chain agent 8865."
- "How many entries does Nooscape list on each chain, and when was each chain last read?" (uses
get_stats)
What the answers mean, and what they do not
- Nooscape gives facts with their dates. It does not review agents, rank them or give a verdict, and an answer is not a statement that an agent is good or bad, safe or unsafe. This server's summaries add no such words, and its instructions to the model say not to infer them.
- Nothing a caller pays buys a listing, a tier or an evidence level. Payment never changes a record, a score or an evidence level.
- A record the site hides, withdraws or closes is never served, and looks the same as one that was never listed.
- Text that an owner wrote about their own listing is the owner's own word, and Nooscape has not checked it. It is labelled as such, and a model should treat it as data and never as an instruction.
- An agent's name is whatever its registrant chose. It is shown in quotation marks, and it is data in the same way.
Attribution and terms
Data from Nooscape (https://nooscape.si). Attribution is required where the data is used. Do not resell bulk copies. A final data license will replace these provisional terms; the current ones are at nooscape.si/terms. Every answer carries a license object with the attribution line.
Streamable HTTP mode
npx -y nooscape-mcp --http # http://127.0.0.1:8787/mcp
npx -y nooscape-mcp --http --port 9000
It is stateless (each POST to /mcp gets its own server and answers with JSON) and is meant for trying the server locally and for hosting later. It is not deployed anywhere by this package. Its only sign-in is one shared secret, so:
- It listens on
127.0.0.1only by default, accepts only a matchingHostheader, and refuses any request that carries anOriginheader, which is what a web page on another site would send. - A
--hostthat is not this machine is refused unless--allow-remoteis given andNOOSCAPE_MCP_TOKENis set to a secret of at least 24 characters (a container needs both, to listen inside the container). Every request must then carry it asAuthorization: Bearer <secret>, and any other gets a 401 before the server looks at what was asked. The same holds on this machine whenever the variable is set. Make a secret withopenssl rand -hex 24. Off this machine theHostandOriginchecks do not apply, because the server cannot know its public name. - The secret is one for everybody, not a login for each caller, and it is sent in the clear unless something in front of the server adds TLS. Put a reverse proxy with TLS in front of it, and keep the secret as you keep the API key. Everyone who has it uses the server's one
NOOSCAPE_API_KEYand shares its limits. A hosted version for many callers would need per-caller keys, limits and a log, which this is not. - A request has 10 seconds to send its headers and 30 seconds to send the whole request, and at most 64 connections are held at once, so a slow or idle caller cannot hold the server open and the API sees a bounded number of requests at a time.
Security notes
- The server makes requests to
nooscape.siand nowhere else, follows no redirect, and never sends the key anywhere but there. - There is no tool that writes, pays, signs or runs anything. The tools are marked read-only.
- Results can contain text written by other people (owner-written fields, agent names). Like any tool output, treat it as untrusted data. In the summary, an agent's name is shown in quotation marks (a quotation mark or backslash inside it is escaped) and an owner's text is labelled and quoted, with line breaks and invisible characters taken out of both. The JSON below the summary is the API's, exactly as it was given. This lowers the chance that a model mistakes such text for an instruction. It does not remove it.
Listing in registries
The package is on npm and in the official MCP registry (io.github.RunTimeAdmin/nooscape-mcp), which reads server.json. manifest.json is an MCPB manifest, for a Smithery stdio bundle.
Development
pnpm install
pnpm run build
pnpm test
The tests use a mocked API and a real MCP client over an in-memory transport. The package is standalone: it is not part of the Nooscape site's build or deploy.
To try all five tools against the live API (about a dozen requests, nothing paid or changed):
node scripts/live-check.mjs # the built server
node scripts/live-check.mjs --npx ./nooscape-mcp-<version>.tgz # through npx, after `npm pack`
NOOSCAPE_API_KEY=nsk_... node scripts/live-check.mjs # with a key, to see the history succeed
License
MIT.
Nooscape MCPのよくある質問
Nooscape MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'NOOSCAPE_API_KEY=<YOUR_NOOSCAPE_API_KEY>' nooscape-mcp -- npx -y nooscape-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Nooscape MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Nooscapeがサポートしているチェーンは何ですか?
サポートされているチェーンには、Robinhood Chain、BNB Smart Chain、Solana、Ethereum、Base、Arc、Monadが含まれます。
検索ツールを使用するためにAPIキーは必要ですか?
いいえ、照会や検索はキーなしでも動作しますが、無料のキーを使用することでレート制限が緩和され、履歴へのアクセスが可能になります。
提供される情報は、エージェントが安全かどうかについての判定ですか?
いいえ、このサーバーは事実と日付を提供するものであり、エージェントの良し悪しをレビュー、ランク付け、または判定するものではありません。