ORANO personal MCP — curl examples

Minimal, copy-paste examples for reading your own ORANO library through the personal, read-only MCP server. No SDK required.

• Endpoint & auth format: https://oranoai.com/mcp.json
• Overview: https://oranoai.com/mcp
• Key management: https://oranoai.com/mcp-access.html

Setup

BASE="https://orano-ai-backend-1037939693300.us-central1.run.app/mcp/"
KEY="YOUR_ORANO_PERSONAL_KEY"   # generate at oranoai.com/mcp-access.html (subscription required)

1. Initialize the session

curl -s -X POST "$BASE" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Copy the mcp-session-id response header into SID for later calls:

SID="PASTE_SESSION_ID"

2. List your projects

curl -s -X POST "$BASE" -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" -H "mcp-session-id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_projects","arguments":{}}}'

3. Search your library

curl -s -X POST "$BASE" -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" -H "mcp-session-id: $SID" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_library","arguments":{"query":"pgvector"}}}'

4. Read curated memory facts

curl -s -X POST "$BASE" -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" -H "mcp-session-id: $SID" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_memory_facts","arguments":{}}}'

Available tools

list_projects · get_project · get_pending_handoffs · search_library · get_memory_facts

Boundaries

Read-only (scope orano:read), personal keys, 240 calls / 60 min budget, up to 10 active keys. No OAuth yet — keys are provisioned manually after subscribing.

ORANO app: iOS · Android · oranoai.com