ORANO MCP

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

Listed in the Official MCP Registry

This server is published in the official MCP Registry: io.github.manuvamp/orano-personal-context-mcp (streamable-http). Browse it at https://registry.modelcontextprotocol.io or search there for "orano". Also listed on mcpservers.org.

Quick check that the registry knows the server:

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=orano"

Setup guides

• Claude Code: one claude mcp add --transport http command, or a .mcp.json with an env-var key
• Cursor: mcp.json with url + Authorization: Bearer ${env:ORANO_MCP_KEY}
• Three ways to use saved videos in ChatGPT, Claude or Cursor
• Machine-readable connection details: https://oranoai.com/mcp.json

Use with Gemini CLI / Cursor

Create a personal key in the ORANO app (or at https://oranoai.com/mcp-access.html), then:

Gemini CLI (installs gemini-extension.json and prompts for the key, stored in your keychain):

gemini extensions install https://github.com/manuvamp/orano-mcp-examples

Or set it by hand: export ORANO_API_KEY="YOUR_ORANO_PERSONAL_KEY".

Cursor: set ORANO_API_KEY in your environment, then copy .mcp.json to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects). It uses "Authorization": "Bearer ${env:ORANO_API_KEY}"; no secret is stored in the file.