Skip to main content

​
1. Create an API key

In the app:
  1. Open Account -> API Keys (/account/api-keys).
  2. Click Add New API Key.
  3. Copy the key immediately.
API keys are shown only once after creation.

​
2. List your workspaces

Use the API key to fetch available organizations: 
curl -s https://developer.api.receiptor.ai/v1/workspaces \
  -H "Authorization: Bearer $RECEIPTOR_API_KEY"
Pick the orgId you want to operate in.

​
3. Discover capabilities

curl -s https://developer.api.receiptor.ai/v1/capabilities
Use capability slug values for execution (for example, documents.search).

​
4. Execute a capability with workspace context

curl -s -X POST https://developer.api.receiptor.ai/v1/capabilities/documents.search \
  -H "Authorization: Bearer $RECEIPTOR_API_KEY" \
  -H "X-Receiptor-Org-Id: $RECEIPTOR_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "uber",
    "limit": 5,
    "outputMode": "compact"
  }'

​
5. Run the same flow in CLI

receiptor auth sk_...
receiptor workspace list
receiptor workspace use org_...
receiptor list
receiptor documents search --query "uber" --limit 5

​
6. Validate MCP tools

Using your MCP client:
  1. Call initialize
  2. Call tools/list
  3. Call tools/call with a capability tool name such as documents_search

​
Next