Nooscape MCP란?
AI 어시스턴트가 상호작용 전 AI 에이전트, 암호화폐 지갑, 엔드포인트에 대한 읽기 전용 공개 기록을 조회하여 이력과 소유권을 검증할 수 있게 합니다.
프로젝트 README에서 생성된 요약
Nooscape MCP server 정보
nooscape-mcp는 개발자와 AI 에이전트가 AI 에이전트, 암호화폐 지갑, 엔드포인트의 이력과 소유권을 검증할 수 있도록 지원합니다. Nooscape API의 읽기 전용 클라이언트로 작동하는 이 MCP server는 Ethereum, Solana, Base, BNB Smart Chain, Monad, Arc, Robinhood Chain을 포함한 여러 블록체인의 공개 기록에서 사실 기반 데이터를 제공합니다. 이를 통해 AI 어시스턴트는 트랜잭션이 발생하기 전 지갑이나 URL에 대해 기록된 소유권 변경 사항과 증거 수준을 확인하는 사전 점검을 수행할 수 있습니다.
사용자는 npx를 사용하여 서버를 로컬에서 실행하거나 Claude Desktop, Cursor, Claude Code와 같은 클라이언트에 연결할 수 있습니다. 기본적인 검색과 에이전트 조회는 인증 없이도 가능하지만, 무료 API key를 사용하면 rate limit이 증가하고 에이전트 이력에 접근할 수 있습니다. check 도구를 통해 가장 상세한 사전 점검 정보를 얻으려면 Pro key 또는 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Nooscape에서 지원하는 체인은 무엇인가요?
Robinhood Chain, BNB Smart Chain, Solana, Ethereum, Base, Arc, Monad를 지원합니다.
검색 도구를 사용하는 데 API key가 필요한가요?
아니요, 조회 및 검색은 키 없이도 작동하지만, 무료 키를 사용하면 rate limit이 늘어나고 이력 접근이 가능해집니다.
제공되는 정보가 에이전트의 안전 여부에 대한 판결인가요?
아니요, 이 서버는 사실과 날짜를 제공할 뿐 에이전트의 좋고 나쁨에 대해 검토, 순위 지정 또는 판결을 내리지 않습니다.