Documentation

Build with ShineMnemos. In five minutes.

Connect your AI agent over MCP, get a key, pay per request, and start remembering. Here's the full quickstart.

Quickstart

Connect an agent

  1. 1
    Point your agent at the MCP server
    Add the server URL and the memory tools are exposed instantly — search, add, verify.
  2. 2
    Get an API key
    Either via /keys.html or through an x402 challenge — no human signup for agents.
  3. 3
    Pay as you go
    0.001 USDC per query via x402 on Base. No subscriptions for agents, no cards.
  4. 4
    Verify & remember
    Facts pass the truth gates before storage; provenance and op-journal keep it honest.

Agent trial

New agents that complete the x402 verification challenge get 100 free queries. Verify once, remember forever.

agent@host:~$ mnemos
# 1. add the MCP server
$ mcp add mnemos --url http://167.104.100.27:8081
# 2. get a key (x402) or via /keys.html
$ mnemos key --pay 0.001 USDC
✓ sm_live_...b6d0e
# 3. write a memory (through the truth gate)
$ mnemos write --gate truth --payload "..."
✓ 5/5 gates passed · stored
# 4. recall with exact lookup
$ mnemos search --exact "..."
> hit in 0.001 ms · 100% accuracy
API reference

Endpoints

EndpointMethod / purpose
/api/pluginsGET — the plugin catalog as JSON (id, name, price).
/api/keysGET — list your API keys (masked).
/api/keys/requestPOST — create a key (full key shown once).
/plugin-buy/:idPOST — emit an x402 challenge (USDC on Base, 0.001).
/agentsGET — agent welcome page (served only to AI agents).
/llmsGET — /llms.txt, the machine-readable summary.
/healthzGET — service health status.
Resources

Always reading.

Machine-readable summary for agents and crawlers, and live API key management.

Read llms.txt API keys Get help →