API and MCP | Context

Start a task with one request

Send the brief to the task API and get a task back at once. Retries with the same key never start it twice.

maya@macbook: ~/brindle

$ curl -s -X POST https://app.context.ai/api/v1/tasks \ -H "Authorization: Bearer $CONTEXT_TASK_KEY" \ -H "Idempotency-Key: q3-review-0927" -d @task.json

{ "taskId": "task_8d2f41c0", "namespace": "brindle-capital", "status": "queued", "createdAt": "2026-09-27T09:20:02.038Z", "location": "/api/v1/tasks/task_8d2f41c0"}

$ curl -s https://app.context.ai/api/v1/tasks/task_8d2f41c0 \ -H "Authorization: Bearer $CONTEXT_TASK_KEY"

{ "taskId": "task_8d2f41c0", "status": "succeeded", "completedAt": "2026-09-27T09:24:51.402Z", "output": { "text": "The deck is ready, 12 slides.", "files": [{ "name": "q3-portfolio-review.pptx", "uri": "org_drive://…" }], "appliedSkills": [{ "skillId": "quarterly-portfolio-review" }] }}

Get the finished work back

Read the task when it is done: the answer, the files it made and the skills it used.

Files

1 items New

FiltersType People Modified Sort: Name

Brindle CapitalQ3 portfolio review deck

Name	Written by	For	Modified	Size
q3-portfolio-review.pptx	AtlasAgent	Maya Okafor	1h ago	4.1 MB
task.md	Context	Maya Okafor	1h ago	3 KB

Give each script its own key

Create a key with only the capabilities a script needs, limit it to chosen agents, and set it to expire.

New task key

For scripts that create tasks, upload files, or read evals.

NameCRM sync

Key typePersonalTasks run as you. The key cannot act on behalf of other users.Service account (agent)Service account (can impersonate)

CapabilitiesCreate tasksRead tasksUpload filesDownload filesRead evalsRead workflowsExpires (optional)Dec 31

The key is shown once, right after you create it.CancelCreate key

Run agent tasks from any system

The task API is how a CRM, a data pipeline or a scheduled job hands work to an agent and collects the result.

maya@macbook: ~/brindle

$ curl -s -X POST https://app.context.ai/api/v1/tasks \ -H "Authorization: Bearer $CONTEXT_TASK_KEY" \ -H "Idempotency-Key: q3-review-0927" -d @task.json

{ "taskId": "task_8d2f41c0", "namespace": "brindle-capital", "status": "queued", "createdAt": "2026-09-27T09:20:02.038Z", "location": "/api/v1/tasks/task_8d2f41c0"}

$ curl -s https://app.context.ai/api/v1/tasks/task_8d2f41c0 \ -H "Authorization: Bearer $CONTEXT_TASK_KEY"

{ "taskId": "task_8d2f41c0", "status": "succeeded", "completedAt": "2026-09-27T09:24:51.402Z", "output": { "text": "The deck is ready, 12 slides.", "files": [{ "name": "q3-portfolio-review.pptx", "uri": "org_drive://…" }], "appliedSkills": [{ "skillId": "quarterly-portfolio-review" }] }}

maya@macbook: ~/brindle

$ curl -s https://app.context.ai/api/v1/tasks/task_8d2f41c0 \ -H "Authorization: Bearer $CONTEXT_TASK_KEY"

{ "taskId": "task_8d2f41c0", "status": "succeeded", "completedAt": "2026-09-27T09:24:51.402Z", "output": { "text": "The deck is ready, 12 slides.", "files": [{ "name": "q3-portfolio-review.pptx", "uri": "org_drive://…" }], "appliedSkills": [{ "skillId": "quarterly-portfolio-review" }] }}

Scope every key to its job

Admins create keys in Settings, each one limited to what the script that holds it has to do.

New task key

For scripts that create tasks, upload files, or read evals.

NameCRM sync

Key typePersonalTasks run as you. The key cannot act on behalf of other users.Service account (agent)Service account (can impersonate)

CapabilitiesCreate tasksRead tasksUpload filesDownload filesRead evalsRead workflowsExpires (optional)Dec 31

The key is shown once, right after you create it.CancelCreate key

New task key

For scripts that create tasks, upload files, or read evals.

NameCRM sync

Key typePersonalTasks run as you. The key cannot act on behalf of other users.Service account (agent)

CapabilitiesCreate tasksRead tasksUpload filesDownload files

The key is shown once, right after you create it.CancelCreate key

Reach Context from your AI tools

Context runs an MCP server at your deployment's address, so tools like Claude Code, Codex and Cursor can work with your files, apps and skills.

Files

8 items New

FiltersType People Modified Sort: Name

Brindle Capital

Q3 portfolio review deck

Projects

Shared with team

Templates

PPTX

q3-portfolio-review.pptx

Sep 10, 2026 · 4.1 MB

X

q3-valuation-bridge.xlsx

Sep 10, 2026 · 212 KB

DOCX

q3-portfolio-updates.docx

Sep 9, 2026 · 96 KB

PPTX

lp-letter.pptx

Sep 9, 2026 · 1.4 MB

Files

8 items New

FiltersSort: Name

Brindle Capital

Q3 portfolio review deck

Projects

Shared with team

Templates

PPTX

q3-portfolio-review.pptx

Sep 10, 2026 · 4.1 MB

X

q3-valuation-bridge.xlsx

Sep 10, 2026 · 212 KB

DOCX

q3-portfolio-updates.docx

Sep 9, 2026 · 96 KB

PPTX

lp-letter.pptx

Sep 9, 2026 · 1.4 MB

Secure by default

Every request carries a key or a token tied to a person or an agent, and the work it starts runs under the same rules as work started in the app.

Audit log

Who granted, shared and revoked access across the organization, and every agent permission decision, with who answered.

All events All actors Last 30 days

Time (UTC)	Outcome	Event
Today
09:39:02.118	Allowed	Atlas changed q3-portfolio-review.pptx · approved by Priya Natarajan
09:38:41.774	Asked	Atlas asked to change q3-portfolio-review.pptx · sent to a person to decide
09:38:40.210	Recorded	Atlas read q3-valuation-bridge.xlsx · for Priya Natarajan
09:31:12.530	Recorded	Maya Okafor opened Covenant headroom
09:31:05.064	Granted	Ledger published Covenant headroom · to Brindle Capital
09:30:52.301	Recorded	Ledger created Covenant headroom · for Maya Okafor
09:30:48.957	Granted	Ledger connected Q3 portfolio review deck · to Covenant headroom, read only
09:24:48.902	Recorded	Atlas wrote q3-portfolio-review.pptx · under Q3 portfolio review deck, for Maya Okafor
09:24:12.388	Recorded	Atlas read q3-portfolio-updates.docx · for Maya Okafor
09:21:30.217	Granted	Maya Okafor granted Editor on Q3 portfolio review deck · to Ledger
09:20:11.645	Recorded	Maya Okafor sent a message in #q3-portfolio-review
09:13:27.390	Recorded	Ledger wrote q3-valuation-bridge.xlsx · under Q3 portfolio review deck, for Maya Okafor
09:04:55.081	Recorded	Scout wrote q3-portfolio-updates.docx · under Q3 portfolio review deck, for Maya Okafor
09:02:19.446	Recorded	Maya Okafor sent a message in #q3-portfolio-review

Showing 1 to 14 of 97 events

Audit log

Who granted, shared and revoked access across the organization, and every agent permission decision, with who answered.

All events All actors

Time (UTC)	Outcome	Event
Today
09:39	Allowed	Atlas changed q3-portfolio-review.pptx · approved by Priya Natarajan
09:38	Asked	Atlas asked to change q3-portfolio-review.pptx · sent to a person to decide
09:38	Recorded	Atlas read q3-valuation-bridge.xlsx · for Priya Natarajan
09:31	Recorded	Maya Okafor opened Covenant headroom
09:31	Granted	Ledger published Covenant headroom · to Brindle Capital
09:30	Recorded	Ledger created Covenant headroom · for Maya Okafor
09:30	Granted	Ledger connected Q3 portfolio review deck · to Covenant headroom, read only
09:24	Recorded	Atlas wrote q3-portfolio-review.pptx · under Q3 portfolio review deck, for Maya Okafor
09:24	Recorded	Atlas read q3-portfolio-updates.docx · for Maya Okafor
09:21	Granted	Maya Okafor granted Editor on Q3 portfolio review deck · to Ledger
09:20	Recorded	Maya Okafor sent a message in #q3-portfolio-review
09:13	Recorded	Ledger wrote q3-valuation-bridge.xlsx · under Q3 portfolio review deck, for Maya Okafor
09:04	Recorded	Scout wrote q3-portfolio-updates.docx · under Q3 portfolio review deck, for Maya Okafor
09:02	Recorded	Maya Okafor sent a message in #q3-portfolio-review

Showing 1 to 14 of 97 events

Use it wherever your code runs

Call the API from any language that speaks HTTP, use the command line from a terminal, and watch the same tasks in the web and phone apps.

Terminal

Run Context's agent in your terminal. Sessions appear here as tasks.

Install the CLImacOSWindowsLinux

Run in your terminalcurl -fsSL https://app.context.ai/install.sh | sh

Sign in from the terminal

After installing, this prints a pairing code and opens the approval page. Approve it and the terminal is connected.

Login commandcontext login

Paired machines

Machines that run dispatched tasks, yours in every workspace, whichever one you paired it from.

Maya's MacBook ProOnline · 1/4 running · paired today

Paired terminals

maya@macbookSign-in key · last used just now

maya@macbook: ~/brindle

$ curl -s -X POST https://app.context.ai/api/v1/tasks \ -H "Authorization: Bearer $CONTEXT_TASK_KEY" \ -H "Idempotency-Key: q3-review-0927" -d @task.json

{ "taskId": "task_8d2f41c0", "namespace": "brindle-capital", "status": "queued", "createdAt": "2026-09-27T09:20:02.038Z", "location": "/api/v1/tasks/task_8d2f41c0"}

$ curl -s https://app.context.ai/api/v1/tasks/task_8d2f41c0 \ -H "Authorization: Bearer $CONTEXT_TASK_KEY"

{ "taskId": "task_8d2f41c0", "status": "succeeded", "completedAt": "2026-09-27T09:24:51.402Z", "output": { "text": "The deck is ready, 12 slides.", "files": [{ "name": "q3-portfolio-review.pptx", "uri": "org_drive://…" }], "appliedSkills": [{ "skillId": "quarterly-portfolio-review" }] }}

maya@macbook: ~/brindle

$ curl -s https://app.context.ai/api/v1/tasks/task_8d2f41c0 \ -H "Authorization: Bearer $CONTEXT_TASK_KEY"

{ "taskId": "task_8d2f41c0", "status": "succeeded", "completedAt": "2026-09-27T09:24:51.402Z", "output": { "text": "The deck is ready, 12 slides.", "files": [{ "name": "q3-portfolio-review.pptx", "uri": "org_drive://…" }], "appliedSkills": [{ "skillId": "quarterly-portfolio-review" }] }}

Work across the Context platform

A task started from code runs on the same engine, with the same skills, connectors and audit log, as one started in the app.

Home

Fri, Sep 11 72°

RecentPinnedTasks

q3-portfolio-review.pptx1h ago
q3-valuation-bridge.xlsx2h ago
q3-portfolio-updates.docx3h ago
lp-letter.pptx5h ago

Working on Q3 portfolio review deck

Home

Fri, Sep 11 72°

RecentPinnedTasks

q3-portfolio-review.pptx1h ago
q3-valuation-bridge.xlsx2h ago
q3-portfolio-updates.docx3h ago
lp-letter.pptx5h ago

Working on Q3 portfolio review deck

Deploy in your environment

Run the API and the MCP server inside your own deployment, on your own address, behind your own identity provider.

Runs on your Kubernetes cluster
Your own API address
Air-gapped installation
SAML and OIDC with SCIM

How deployment works

Your cluster, your addressThe API and the MCP server run on your own Kubernetes cluster, at your deployment's address.
Your model gatewayReach models through the Context Gateway, LiteLLM, Amazon Bedrock, Azure OpenAI or a PrivateLink endpoint.
Air-gapped installationInstall without internet access, with the air-gapped installation tested in CI.
Your identity providerSign people in with SAML or OIDC and provision them with SCIM.

Context runs in production at Qualcomm. Read the case study

Amazon EKS
Azure AKS
Air-gapped

The API and MCP server are included in every Context workspace, including the Free plan.

Free$0Includes API and MCP
Plus$20Per person per month
EnterpriseCustomEnterprise deployments run in your own cloud.Talk to us about a plan

Questions

What can the task API do?

Create a task, read its status and output, cancel it, share it and download the files it made. It also uploads files, manages workflows and reads evals.

What happens if my request is sent twice?

Each create carries an idempotency key. A repeat with the same key returns the task already started instead of starting another.

How do webhooks work?

Ask for webhook delivery and give a signing secret when you create the task. When it finishes, Context sends the result signed with that secret, with an event id and a timestamp, and tries up to three times.

Which AI tools work with the MCP server?

Any MCP client that supports OAuth sign-in, such as Claude Code, Codex and Cursor. Point it at your deployment's MCP address and approve it on the consent page.

Is there an SDK?

The API is plain HTTP with JSON, so any language can call it. Ask your account team for the API reference for your deployment.

Who can create keys?

Admins create task keys in Settings > API Keys. Each key has the capabilities you choose, an optional list of agents and an optional expiry.

Build on Context

Get started Talk to us