Architecture Overview
The request flow from user input to on-chain payment settlement.
Tech Stack
The technologies powering Solva MCP.
Category Detection
Keyword-based mapping from natural language tasks to service categories (news, search, summarize, weather). Extensible via the CATEGORY_KEYWORDS map.
Policy Engine
JSON-based rules that filter services by max price, min uptime, min payment history, and daily budget. Agents never spend beyond operator-defined limits.
Service Registry
A JSON marketplace of x402 services with pricing, uptime stats, and payment history. Services are filtered and sorted by the policy engine before selection.
Payment Engine
Sends real USDC micropayments on Stellar testnet using Ed25519 signing. Supports both full x402 negotiation and direct Soroban transfers for mock services.
Project Structure
├── src/
│ ├── index.ts ← MCP server + tool registration
│ ├── helpers.ts ← Category detection, filtering, mock results
│ ├── payment.ts ← Direct Stellar USDC payment
│ └── stellar/ ← Vendored x402 Stellar implementation
│ ├── constants.ts
│ ├── signer.ts
│ ├── shared.ts / utils.ts
│ └── exact/ ← ExactStellarScheme
├── registry.json ← Service marketplace (4 services)
├── policy.json ← Agent spending rules
├── scripts/
│ └── setup-trustline.ts ← One-time USDC trustline setup
├── landing/ ← This website
└── package.json / tsconfig.json
Quick Integration
Add Solva to any MCP-compatible agent or IDE in seconds.
claude mcp add solva npx tsx /path/to/solva-mcp/src/index.ts
// Cursor / VS Code / Windsurf — MCP config
{
"mcpServers": {
"solva": {
"command": "npx",
"args": ["tsx", "/path/to/solva-mcp/src/index.ts"],
"env": { "STELLAR_SECRET_KEY": "S..." }
}
}
}
Add a Category
Edit CATEGORY_KEYWORDS in helpers.ts and add a new service to registry.json. Solva will automatically route matching tasks.
Customize Policy
Edit policy.json to adjust maxPriceUSDC, minUptimePct, minTotalPayments, and dailyBudgetUSDC for your use case.