ASPERN MCP server
Commit Nov 4, 2026Provides on-chain counterparty evidence and vault data to help autonomous agents and capital allocators verify addresses before making payments.
Also known as aspern-org/aspern-docs, aspern-docs
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.3.0
- Last commit
- Nov 4, 2026
- License
- —
What is ASPERN MCP?
ASPERN provides on-chain counterparty evidence and vault data to help autonomous agents and capital allocators verify addresses before making payments.
Summary generated from the project's README
About ASPERN MCP server
ASPERN serves as an independent, read-only evidence service designed for autonomous agents and capital allocators. It provides on-chain data to help users verify addresses before making payments or depositing funds into vaults. By reading public on-chain and venue data, the server answers specific questions regarding counterparty behavior and vault contents, such as who controls a vault or when an address was last paid.
Users connect to the service via a streamable HTTP transport, making it compatible with Claude Code, Claude Desktop, Cursor, and VS Code. While free tools require no API keys or payments, certain paid endpoints use the x402 protocol for USDC payments. When a paid call is requested, the endpoint returns a 402 Payment Required status indicating the price. The service focuses on providing raw readings with timestamps and sources rather than offering credit ratings or investment advice.
What you can do with it
- 1Verify counterparty reliabilityAn agent can check if a specific address has a history of delivering services or paying back others before initiating a transaction.
- 2Audit vault securityA developer can investigate the control mechanisms and holdings of a vault before committing capital.
- 3Discover service pricingAn autonomous agent can determine the cost of a paid data endpoint before executing a payment.
Written from the project's README. Every use case is checked against a quote from it.
How to install ASPERN MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ASPERN MCP in Claude Code
$ claude mcp add --transport http aspern-docs https://aspern.org/mcpInstall ASPERN MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"aspern-docs": {
"url": "https://aspern.org/mcp"
}
}
}Install ASPERN MCP in VS Code
.vscode/mcp.json
{
"servers": {
"aspern-docs": {
"type": "http",
"url": "https://aspern.org/mcp"
}
}
}Install ASPERN MCP in VS Code CLI
$ code --add-mcp '{"name":"aspern-docs","type":"http","url":"https://aspern.org/mcp"}'Install ASPERN MCP in Codex
$ codex mcp add aspern-docs --url https://aspern.org/mcpInstall ASPERN MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.aspern-docs] url = "https://aspern.org/mcp"
Install ASPERN MCP in Gemini CLI
$ gemini mcp add -s user --transport http aspern-docs https://aspern.org/mcpInstall ASPERN MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"aspern-docs": {
"url": "https://aspern.org/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableaspern-org/aspern-docs is public and reachablegithub.com/aspern-org/aspern-docs ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-04github.com/aspern-org/aspern-docs ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 454 msPass
README
View on GitHubASPERN
What the chain records about an address before you pay it, and whether a payment fits it.
ASPERN is an independent, read-only evidence service for autonomous agents and the people who allocate capital to them. It reads public on-chain and venue data and answers two kinds of question:
- Before paying or hiring an agent: who pays this address, whether it pays them back, whether it delivers, whether its service answers, when it was last paid.
- Before depositing into a vault: what it holds, who controls it, what a withdrawal of a given size would actually return, and which readings are missing.
Every figure carries the time it was read and its source. A figure we could not measure is named as not measured, never shown as zero.
This repository holds the public documentation: how to connect, what each tool and endpoint does, what it costs, and the server's registry entry. The service itself is hosted; its source code is not published.
- Website: https://aspern.org
- MCP server:
https://aspern.org/mcp(streamable HTTP) - REST API:
https://aspern.org/api/v1· OpenAPI: https://aspern.org/api/v1/openapi.json - Agent card: https://aspern.org/.well-known/agent-card.json
- Methodology: https://aspern.org/methodology
Connect
No install. The free tools need no key.
Claude Code
claude mcp add --transport http aspern https://aspern.org/mcp
Claude Desktop / claude.ai: Settings → Connectors → Add custom connector →
https://aspern.org/mcp.
Cursor (.cursor/mcp.json) and other clients that take a URL:
{
"mcpServers": {
"aspern": { "url": "https://aspern.org/mcp" }
}
}
VS Code (.vscode/mcp.json):
{
"servers": {
"aspern": { "type": "http", "url": "https://aspern.org/mcp" }
}
}
Raw JSON-RPC:
curl -s https://aspern.org/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Examples
In examples/, each one runnable as is:
counterparty-check.sh 0xADDRESS— the free counterparty record over RESTmcp-call.sh <tool> '<json args>'— any MCP tool over plain JSON-RPCx402-price-discovery.sh 0xADDRESS— a paid endpoint's402answer, which states its price
Tools
The full list, with each tool's description and input schema as the server returns it, is in
docs/tools.md (generated from tools/list, dated; refresh with
node scripts/gen-docs.mjs). The agent card is mirrored in docs/agent-card.json. The server is the
source of truth: if the two differ, the server is right and this file is stale.
Pricing
Free tools need no key and no payment. Paid calls are priced per call and paid over
x402 (USDC); the endpoint answers 402 Payment Required with the
price and how to pay it, so an agent can discover the price before it pays. Current prices:
https://aspern.org/data and docs/pricing.md (generated).
What ASPERN does not do
- It never holds, moves or signs for anyone's funds.
- It does not rank, rate or recommend. A reading describes the record behind a figure; it is not a credit rating and not investment advice.
- It does not accept paid placement.
Registry entry
server.json is the entry published to the
official MCP registry as org.aspern/aspern.
Contact and security
- Corrections and questions: see https://aspern.org/support
- Security reports:
SECURITY.mdand https://aspern.org/.well-known/security.txt
Licence
The documentation in this repository is licensed under CC BY 4.0. The ASPERN service, its data and its source code are not covered by this licence; see https://aspern.org/terms.
ASPERN MCP questions
How do I add ASPERN MCP to Claude Code?
Run claude mcp add --transport http aspern-docs https://aspern.org/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ASPERN MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does ASPERN require an API key for all tools?
No, the free tools do not require a key or any payment.
Does ASPERN provide credit ratings or investment advice?
No, the service provides readings of records and does not rank, rate, recommend, or provide investment advice.
Can ASPERN manage my funds?
No, the service never holds, moves, or signs for any user's funds.