Model Context Protocol (MCP)
Specie is designed for intelligence — built to communicate with AI agents and Onli systems through the Model Context Protocol (MCP). MCP is how cognition interacts with value: a universal, signed interface that allows models to act safely in the economic layer.
What MCP Does
MCP is a signing proxy that:
- • Takes the user's credentials (API key and secret)
- • Generates a unique HMAC-SHA256 signature per request
- • Sends an authenticated, timestamped call
- • Returns a Receipt — a human-readable, mathematically verified proof
Headers Sent With Every Request
X-API-Key: [user's API key] X-Nonce: [unique UUID] X-Timestamp: [current ISO-8601 time] X-Event-Id: [unique transaction ID] X-Signature: HMAC-SHA256(body + nonce + timestamp, secret)
These headers form the trust envelope — the cryptographic handshake that makes every Specie call verifiable and non-repudiable.
Example — Full MCP Request
POST /mcp/eventRequest HTTP/1.1
Host: api.specie.market
Content-Type: application/json
X-API-Key: spk_live_3c02a8...
X-Nonce: 3b251b98-90f6-48c3-b012-1ddfbb3eaa4f
X-Timestamp: 2025-11-06T19:02:41Z
X-Event-Id: evt_58f29cd4b8
X-Signature: 6b9d73b242b91f02c9cf20a6d45fd6e1ef4eaf3d9b1c7b3f8a2...
{
"protocol": "mcp",
"version": "1.0.0",
"tool": "Specie",
"action": "BUY",
"parameters": {
"amount": 1000,
"to": "treasury",
"payWith": {
"currency": "USDT_TRC20",
"proof": "npmt_7EZ..."
}
},
"context": {
"user_onli_id": "usr-97b8a92c-fd34-4c4c-b1aa-02f83a5c4b9e",
"vault_id": "vault-4b7a12d",
"intent": "ISSUE",
"meta": {
"client_ref": "chat-agent-001",
"description": "Agent-initiated treasury purchase"
}
}
}Example Response
{
"receipt": {
"eventId": "evt_58f29cd4b8",
"status": "completed",
"intent": "ISSUE",
"timestamp": "2025-11-06T19:02:44Z",
"owner": "usr-97b8a92c...",
"proof": "onli_sig_9a27...",
"message": "1,000 SPECIE issued to vault-4b7a12d"
}
}The response is the only record that matters — your Receipt, your proof of value.
The Architecture Truth
MCP isn't just an API layer; it's a verification language.
Every Specie call is a signed declaration of will. Every response is a mathematical confirmation of truth.
MCP performs four operations:
- Takes user credentials
- Creates an HMAC signature
- Makes an authenticated call
- Interprets and returns a verifiable result