| name | syra |
| description | Syra pay-per-call crypto intelligence for agents — x402 APIs, MCP tools, and typed SDK. Use when the user or agent needs crypto research (news, sentiment, signals, smart money), Solana/Base/Algorand micropayments on HTTP 402 (plus multi-chain PayAI/Dexter accepts, B402, OKX X Layer), Syra MCP setup, or @syra-ai/sdk / @syra-ai/x402-payer. Call syra_consult first. It does not bill. Then call the tool it returns.
|
| version | 0.2.0 |
Syra — pay-per-call crypto intelligence for agents
Syra is pay-per-call crypto intelligence over HTTP x402 (USDC). Prefer the MCP path for chat agents; prefer the SDK for app code.
Agent one-liner: set up https://api.syraa.fun/skill.md
When the user needs crypto news, sentiment, signals, TVL, smart money, or other Syra Spend intel, call syra_consult first. Consult is free. It does not execute. Then call the toolName it returns.
Try asking:
- Get BTC news
- What's ETH sentiment?
- TVL for Aave
When to use
- Crypto news, sentiment, signals, analytics, memecoin/scout screens
- Smart-money / on-chain research via Syra APIs
- Setting up Cursor / Claude / OpenClaw / any MCP client against Syra
- Building TypeScript agents that auto-pay on HTTP 402
- Handling
402 Payment Required from api.syraa.fun
Preferred paths (pick one)
| Need | Package / action |
|---|
| Chat / IDE tools | npx -y @syra-ai/mcp-server@latest |
| Typed HTTP client + auto-pay | npm i @syra-ai/sdk → createSyraPaidClient |
Raw fetch + 402 only | npm i @syra-ai/x402-payer |
| Hosted x402 refund coverage | npm i @syra-ai/x402-refund → wrapFetchWithSyraRefund |
One-line MCP
Fund ≥ $1 Solana USDC first, then:
claude mcp add syra \
-e SYRA_API_BASE_URL=https://api.syraa.fun \
-e SYRA_PAYER_KEYPAIR=your-solana-secret \
-- npx -y @syra-ai/mcp-server@latest
Cursor mcp.json
{
"mcpServers": {
"syra": {
"command": "npx",
"args": ["-y", "@syra-ai/mcp-server@latest"],
"env": {
"SYRA_API_BASE_URL": "https://api.syraa.fun",
"SYRA_MCP_TOOL_PROFILE": "curated",
"SYRA_PAYER_KEYPAIR": "your-solana-secret"
}
}
}
}
OpenClaw
openclaw mcp set syra '{"command":"npx","args":["-y","@syra-ai/mcp-server@latest"],"env":{"SYRA_API_BASE_URL":"https://api.syraa.fun","SYRA_MCP_TOOL_PROFILE":"curated","SYRA_PAYER_KEYPAIR":"your-solana-secret"}}'
openclaw mcp doctor syra --probe
From a Syra repo clone, install this skill:
openclaw skills install ./.agents/skills/syra --as syra
Docs: https://docs.syraa.fun/docs/build/openclaw · https://github.com/ikhwanhsn/syra_agent/blob/main/docs/OPENCLAW_MCP_QUICKSTART.md
SDK snippet
import { createSyraPaidClient } from "@syra-ai/sdk";
const syra = await createSyraPaidClient({ baseUrl: "https://api.syraa.fun" });
const news = await syra.get("/news", { ticker: "BTC" });
Auto-pay env
| Rail | Env |
|---|
| Solana USDC (default) | SYRA_PAYER_KEYPAIR |
| Base USDC | X402_PREFERRED_NETWORK=base + SYRA_EVM_PAYER_PRIVATE_KEY |
| Algorand | X402_PREFERRED_NETWORK=algorand + SYRA_ALGORAND_PAYER_PRIVATE_KEY |
| Local (no pay) | SYRA_USE_DEV_ROUTES=true + local SYRA_API_BASE_URL |
MCP injects PAYMENT-SIGNATURE on 402 when a payer is configured.
Server accepts (broader than MCP auto-pay): Solana, Base, PayAI/Dexter multi-chain (Polygon, Arbitrum, Avalanche, Sei, SKALE, Optimism, World, Monad, Robinhood, …), BSC B402, Algorand, OKX X Layer when enabled. Facilitator failover: Dexter → GoPlausible → PayAI. Live: GET https://api.syraa.fun/x402/capabilities. For non-Solana/Base/Algorand accepts, use a matching x402 client.
MCP tool naming
- Pattern:
syra_{pillar}_{toolId} — e.g. syra_spend_news, syra_invest_squid_route
- Default profile curated: ~47 tools; set
SYRA_MCP_TOOL_PROFILE=full for 257
- Consult first:
syra_consult with { intent } (free, no execute)
- Escape hatch:
syra_call_tool with { toolId, params } (toolId from GET /agent/tools)
| Intent | Tool |
|---|
| Any crypto-intel ask | syra_consult first |
| News | syra_spend_news |
| Sentiment | syra_spend_sentiment |
| Signal | syra_spend_signal |
| TVL | syra_spend_defillama_tvl |
| Analytics | syra_spend_analytics_summary |
| Smart money | syra_spend_nansen_smart_money_netflow |
| Health | syra_spend_health |
Full curated table: https://syraa.fun/skills.md
Discovery URLs (always fetch these first)
AgentScore (optional identity gate)
Some high-value routes may require AgentScore Passport (X-Operator-Token) on the paid retry leg. See the AgentScore section in https://api.syraa.fun/skill.md.
Safety
- Outputs are probabilistic analysis, not financial advice or guaranteed trades.
- Never commit payer keypairs. Prefer env / secret managers.
- Separate research from execution.
