Quickstart
If your app already uses an OpenAI SDK, point the base URL at Cortexa and use your Cortexa API key. The model name is
cortexa.curl https://api.cortexa.sh/v1/chat/completions \
-H "Authorization: Bearer $CORTEXA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "cortexa",
"messages": [
{
"role": "user",
"content": "Summarize the evidence for GLP-1 agonists in neuroinflammation. Cite sources."
}
]
}'from openai import OpenAI
client = OpenAI(
api_key="sk-cortexa-live-...",
base_url="https://api.cortexa.sh/v1",
)
response = client.chat.completions.create(
model="cortexa",
messages=[
{
"role": "user",
"content": "Find recent clinical evidence for tau PET as an Alzheimer's endpoint.",
}
],
)
print(response.choices[0].message.content)Endpoint reference
Every endpoint on the v1 surface authenticates with the same bearer token and returns OpenAI-compatible error envelopes.
POST
/v1/chat/completionsOpenAI-compatible chat completion endpoint. Best for existing SDKs and server-side integrations.
POST
/v1/agents/cortexa/runsNative streaming endpoint for text deltas, tool events, citations, and rich data cards.
GET
/v1/runs/{id}Fetch the completed messages, tool invocations, and stream of an earlier run by ID.
GET
/v1/modelsList available Cortexa models. Returns a single entry today; included for OpenAI client compatibility.
GET
/v1/toolsInspect the verified tools the agent can route to per request.
GET
/v1/sourcesBrowse the curated data source catalog the agent can reach.
POST
/mcpMCP endpoint for clients that support streamable HTTP. Desktop stdio clients use the npm adapter.
Native streaming
Native runs stream the agent surface directly: text deltas, tool invocations, source-backed citations, structures, formulas, charts, and usage summaries.
curl https://api.cortexa.sh/v1/agents/cortexa/runs \
-H "Authorization: Bearer $CORTEXA_API_KEY" \
-H "Content-Type: application/json" \
-N \
-d '{
"input": "Compare evidence for two candidate targets and cite primary sources."
}'2.2K+ verified tools behind one model
Cortexa handles tool selection internally. Client applications can stay simple while still benefiting from live literature, biomedical, clinical, genomics, chemistry, structure, patent, and code-execution tools.
Authentication
Send API keys as bearer tokens:
Authorization: Bearer sk-cortexa-live-.... Create and revoke keys from the API Keys dashboard.