Who this is for
- Teams building agentic apps (chat + on-chain actions).
- Developers wiring Cursor / Claude to Abstraxn MCP for internal tools.
- Products that need autonomous transfers, balances, and paid API access per user.
Choose your path
Pick the track that matches your goal. You can combine paths later (for example MCP in Cursor while building your app).Build a full app
Dashboard → SDK → sample backend API + sample web app. Per-user agents, chat, signing on your server.
MCP in IDE only
Copy Overview
mcp.json, use tools from Cursor. No custom backend required for reads and catalog search.x402 & paid APIs
discover_services catalog → paid_fetch → sign paymentPayload on your server with accessKey.| Path | Start here | Then |
|---|---|---|
| Full app | Dashboard setup | SDK → Full-stack integration |
| IDE only | Dashboard setup | MCP in Cursor |
| x402 | Smoke test (discover_services) | x402 payments + SDK for signing |
Complete implementation path
| Step | Doc | Outcome |
|---|---|---|
| 1 | Dashboard setup | API key, MCP URL, agents list, tools catalog |
| 1b | Smoke test | Confirm MCP + catalog with curl (optional, ~5 min) |
| 2 | SDK quickstart | Agents + server wallets + accessKey storage |
| 3 | Full-stack integration | Sample NestJS API + Next.js web app |
| 4 | ERC-8004 identity | On-chain identity (10 supported chainIds) + registration file |
| 5 | MCP tools reference | tools/list discovery and call patterns |
| 6 | x402 payments | discover_services, paid_fetch, signing |
Architecture
| Component | Responsibility |
|---|---|
| Dashboard | Credentials, monitoring agents, browsing MCP tools |
| Agent Kit service | Agent registry, MCP router, x402 facilitator hooks |
@abstraxn/agent-kit | Create agents, provision server wallets, sign txs |
| Your backend | User auth, DB, encrypt accessKey, call MCP for LLM |
| Your frontend | UX only — no Abstraxn secrets |
Credentials
Three different secrets (application API key, per-agent API key, walletaccessKey) are easy to confuse. See the full Credentials cheat sheet — including env vars, headers, and a decision tree.
What agents can do
| Category | Who signs |
|---|---|
| Read wallet / chain (via MCP) | Nobody |
| Move funds (unsigned transfer intents) | Your backend + accessKey |
| Market data & external APIs (x402) | x402 via accessKey on retry |
| On-chain identity (ERC-8004) | Server wallet signs register(agentURI) |
tools/list — see MCP tools reference.
Register agents on-chain and publish a public registration file (MCP endpoint, x402 flag, metadata). See ERC-8004 agent identity.
Sample applications
Abstraxn provides a sample backend API and sample web app you can clone or adapt:| Project | Stack | Shows |
|---|---|---|
| Sample backend API | NestJS, Postgres, JWT | SDK createAgent, MCP chat loop, transfer + x402 signing |
| Sample web app | Next.js | Login, agents, chat SSE, portfolio |
MCP endpoint
| Environment | MCP URL |
|---|---|
| Production | https://agent-kit.abstraxn.com/mcp |
| Dev (example) | https://dev-agent-kit.abstraxn.com/mcp |
/mcp.
Documentation map
Credentials
Application key vs accessKey — when to use each.
5-minute smoke test
curl
tools/list and discover_services after dashboard setup.Dashboard setup
Account → app → Agentic Stack UI walkthrough.
SDK quickstart
@abstraxn/agent-kit install and createAgent (server wallet).External wallet
BYO EVM/Solana address — no accessKey; ERC-8004 with your signer.
ERC-8004 identity
On-chain identity, registration file, dashboard Identity tab.
Full-stack integration
Sample NestJS API + Next.js web app.
MCP tools
Tool-by-tool reference.
x402 payments
Paid HTTP and paymentPayload flow.
MCP in Cursor
IDE setup with Overview snippet.
Troubleshooting
401, agent_id, x402 -32402, funding, signing FAQ.