Keywords AI MCP server: 55 tools, now Respan
The product changed name, and the connector is large. What its nine categories cover, and the header that registers only the tools you name.
Last verified 27 August 2026 · from The vendor's own MCP documentation, published under the Respan name
This page is one of 90 in a directory of monitoring and developer tools. Each page checks what an AI coding agent can get out of the tool through its MCP server, the connector that lets the agent query the tool directly.
Summary
Keywords AI now trades as Respan, and its MCP server is documented under that name at mcp.respan.ai/mcp. The documentation lists 55 tools across nine categories.
The categories are the shape of a language-model observability platform: logs, traces, customers, prompts, experiments, evaluators, evaluation pipelines, workflows and datasets.
It is one of the few connectors here with a documented way to register less. A Respan-Enabled-Tools header takes a comma-separated list of exact tool names. Omitting the header makes all 55 tools available.
What is the Keywords AI MCP server?
It is Respan's server for the Model Context Protocol. The product traces language-model calls and evaluates them, so a connected agent reaches both the traffic and the scoring.
The reading surface is the useful half for most sessions. list_logs and get_log_detail cover request history, while list_traces, get_trace_tree and get_traces_summary cover structure.
The authoring half covers prompt versions, evaluators and workflows, which most observability connectors do not expose. Prompts have versions that can be created and deployed, and evaluators and workflows have their own commit tools.
It is strongest in agent observability, touches cost through logged usage, and reaches nothing in code review or CI.
| Part of the work | What Keywords AI has here | Can an agent reach it |
|---|---|---|
| Code, tests & review | None | Nothing for code or review |
| CI & release | Prompt and workflow deployment | Partial. Deploying a prompt version or a workflow is a release action, but no pipeline is reachable |
| Production observability | Logs and traces of model calls | Partial, and only for model traffic. There are no service metrics and no request traces |
| Agent observability & evals | Logs, traces, experiments, evaluators, pipelines, datasets | Yes. Core strength, across nine documented categories |
| AI cost management | Usage recorded on logs | Partial. Cost and token usage appear where the platform recorded them on a log; there is no billing surface |
For an agent, that means Respan answers what your model calls did, what they scored and what they cost. It can also deploy the next prompt version. It sees nothing outside model traffic, so a service question needs a separate connector.
What can an AI agent do with Keywords AI?
| Task | Tools | Works | Watch out for |
|---|---|---|---|
| Read recent model calls | Enable Logs list_logs get_log_detail | Yes | create_log also exists, so this category writes as well as reads |
| Follow a trace | Enable Traces list_traces get_trace_tree get_traces_summary get_spans_summary | Yes | The tree is the structural view; summaries aggregate |
| Find a customer's traffic | Enable Customers list_customers get_customer_detail | Yes | Customer here means an end user of your product, not an account of yours |
| Manage prompt versions | Enable Prompts list_prompts get_prompt_detail create_prompt_version deploy_prompt_version | Yes | deploy_prompt_version changes what production serves |
| Run and read an experiment | Enable Experiments list_experiments get_experiment create_experiment | Yes | Creating an experiment writes |
| Author an evaluator | Enable Evaluators create_evaluator commit_evaluator delete_evaluator | Yes | Commit and delete both change scoring configuration |
| Work with datasets | Enable Datasets create_dataset bulk_create_dataset_logs delete_dataset | Yes | Bulk creation adds many rows in one call |
Decide the tool scope before the first session. With 55 tools registered by default, the Respan-Enabled-Tools header is the difference between a focused connection and a large one.
55 tools documented across nine categories, all registered unless a header narrows them
- Logs2
list_logsget_log_detail- Traces4
list_tracesget_trace_treeget_traces_summaryget_spans_summary- Customers2
list_customersget_customer_detail- Prompts4
list_promptsget_prompt_detaillist_prompt_versionsget_prompt_version_detail- Experiments2
list_experimentsget_experiment- Writing prompts5Write
create_promptupdate_promptcreate_prompt_versionupdate_prompt_versiondeploy_prompt_version- Writing evaluation5Write
create_evaluatorcommit_evaluatordelete_evaluatorcreate_evaluation_pipelinecreate_experiment- Writing workflows and data6Write
commit_workflowvalidate_workflowcreate_datasetbulk_create_dataset_logsdelete_datasetcreate_log
Groups follow the documentation's own category headings. Counts come from that page, read 24 August 2026; the hosted endpoint returns 401 to an unauthenticated tools/list.
What connecting costs before the first question
A context window is the amount of text a model can hold at once. Fifty-five tools cost 2,815 to 3,407 tokens on Claude if the whole surface loads. Each description is one short line. That is why the tool count is high and the token cost is not.
The Respan-Enabled-Tools header narrows the set to named tools, so a scoped session pays less than this. Within the full 55, the figure is still a floor: no input schemas were available to count.
| Tool set | Tools | Tokens (GPT-5.6, GPT-5.5) | Tokens (GPT-4, GPT-3.5) | Tokens (Claude Haiku 4.5 to Opus 5) | Share of a 200,000-token window |
|---|---|---|---|---|---|
| Every tool documented | 55 | 847 to 1,390 | 832 to 1,375 | 2,815 to 3,407 | 0.4% to 1.7% |
Encodings: GPT-5.6, GPT-5.5 o200k_base; GPT-4, GPT-3.5 cl100k_base; Claude Haiku 4.5 to Opus 5 count_tokens. Counted from the 55 tool entries in the vendor's own documentation. That is the only public inventory.
The server could not be run for a live tools/list. So no input schemas are available. These figures cover each tool's name and description only. They are a floor, not the figure.
The Claude columns are measured through the API's count_tokens endpoint, with an empty schema per tool. So they cover the same content as the GPT columns. The range there is two tokenizer generations. Haiku 4.5 and Opus 4.6 sit at the low end. Opus 5 and Sonnet 5 sit at the high end. The gap between them is about a fifth.
Can Keywords AI watch your own AI agents?
This is the most complete agent-observability surface measured in this guide, with only cost left partial. Read from the vendor's own documentation on 24 August 2026.
| Signal | Covered | Notes |
|---|---|---|
| Trace and session tracking | Yes | list_traces, get_trace_tree, get_traces_summary and get_spans_summary |
| Eval scores on recorded traffic | Yes | Nine evaluator tools, of which create_evaluator, commit_evaluator and delete_evaluator are listed above, plus get_experiment_score_averages |
| Prompt version tracking | Yes | list_prompt_versions, get_prompt_version_detail, create_prompt_version and deploy_prompt_version |
| Offline experiments | Yes | Experiments and datasets both have their own tools, with list_dataset_eval_runs joining them |
| Token and cost tracking | Partial | Usage is recorded on logs and read through them. There is no dedicated cost tool |
Keywords AI MCP server limits: where answers come back incomplete
Keywords AI starts with a large default surface and a changed brand; those two facts shape the limits below.
The product is documented as Respan, not Keywords AI.
The MCP documentation, the endpoint hostname and the scoping header all use the Respan name. Searching under the original brand finds the company rather than the connector.
Guard: Search and configure under Respan, and keep the old name only as a way to recognize the product.
The agent says: “There are a lot of tools here.” All 55 register unless you narrow them.
The documentation states that omitting the Respan-Enabled-Tools header makes all Platform MCP tools available, and that the header takes a comma-separated list of exact tool names.
Guard: Write the enabled list once per kind of session, and treat the full 55 as the exception rather than the default.
The agent says: “I have updated the prompt.” Deployment is a separate, live step.
create_prompt_version and update_prompt_version change a version, while deploy_prompt_version is what makes it serve.
Guard: Exclude deploy_prompt_version from the enabled list unless deploying is the point of the session.
How to configure Keywords AI MCP for agents
- 1
Whitelist the tools you need
Respan-Enabled-Toolstakes a comma-separated list of exact tool names; without it, all 55 are available. - 2
Prefer the API key
The documentation recommends it, with OAuth and a JWT token as fallbacks.
- 3
Decide who may deploy
deploy_prompt_versionchanges what production serves, andcommit_workflowfixes a workflow version. - 4
Know the name
Everything is published as Respan, so searching for Keywords AI documentation will send you in circles.
Paste this into your agent’s instructions
Deployment tools sit in the same list as reading tools, and the tool scope can differ per connection. Both belong in the answer.
When you answer using Respan MCP tools, state: - The project and period the answer covers. - Whether the session was scoped with Respan-Enabled-Tools, and which tools were enabled. - Whether you deployed anything. deploy_prompt_version changes what production serves. Never state that data does not exist. State that no logs or traces matched the filters above. Write your answer in ASD-STE100 Simplified Technical English. Use short sentences with one idea in each.
Do you need the MCP server at all?
Not for a scheduled export. Respan has a REST API, and for that job it avoids both the context cost and the write surface.
The connector earns its place when the loop is short: read the failing trace, adjust the prompt version, and evaluate it without leaving the editor.
For tracing alone, Langfuse and Arize Phoenix cover that ground with narrower connectors.
Connect a scoped session for prompt and evaluation work. Use the API for reporting.
Keywords AI MCP server setup
The server is hosted, so nothing is installed. An API key is the documented recommendation, passed as a bearer token.
OAuth is supported, with a JWT token documented as the fallback where an OAuth flow cannot complete.
Claude Code
The API key travels as a bearer token, which the documentation recommends over the other routes.
claude mcp add --transport http respan \ https://mcp.respan.ai/mcp \ --header "Authorization: Bearer <your-respan-api-key>"
Cursor
In ~/.cursor/mcp.json. The same API key applies.
{"mcpServers":{"respan":{
"url":"https://mcp.respan.ai/mcp",
"headers":{"Authorization":"Bearer <your-respan-api-key>"}}}}Codex CLI
Codex reads TOML, so the JSON blocks above will not transfer. The key still applies.
[mcp_servers.respan]
url = "https://mcp.respan.ai/mcp"
headers = { Authorization = "Bearer <your-respan-api-key>" }Every other client
Each block below is the configuration for one client, with the file path and the key that client expects.
Claude Desktop
macOS ~/Library/Application Support/Claude/claude_desktop_config.json. Windows %APPDATA%\Claude\claude_desktop_config.json. There is no CLI. Edit through Settings, Developer, Edit Config.
Quit and restart fully for changes to load. Paths in args must be absolute. Logs at ~/Library/Logs/Claude/mcp.log.
{"mcpServers":{"respan":{"url":"https://mcp.respan.ai/mcp",
"headers":{"Authorization":"Bearer <your-respan-api-key>"}}}}Gemini CLI
~/.gemini/settings.json globally, or .gemini/settings.json per project. Key mcpServers. CLI: gemini mcp add.
{"mcpServers":{"respan":{"url":"https://mcp.respan.ai/mcp",
"headers":{"Authorization":"Bearer <your-respan-api-key>"}}}}VS Code Copilot
.vscode/mcp.json per workspace, or your user profile. CLI: code --add-mcp.
{"servers":{"respan":{"url":"https://mcp.respan.ai/mcp",
"headers":{"Authorization":"Bearer <your-respan-api-key>"}}}}The key is `servers`, not `mcpServers`. VS Code is the only client that uses that name, and copying a config from anywhere else fails silently.
Windsurf
~/.codeium/windsurf/mcp_config.json, which is the path Windsurf documents. Key mcpServers, the same JSON shape as Cursor, carrying the same credential.
Zed
~/.config/zed/settings.json, carrying the same credential as the blocks above.
The key is `context_servers`. Zed does not call them MCP servers in config, so searching its settings for mcp finds nothing.
Google Antigravity
~/.gemini/config/mcp_config.json globally, or .agents/mcp_config.json per project. Key mcpServers. There is no CLI. Use the /mcp overlay in the editor. Supports stdio, streamable HTTP, SSE and websocket.
{"mcpServers":{"respan":{"url":"https://mcp.respan.ai/mcp",
"headers":{"Authorization":"Bearer <your-respan-api-key>"}}}}Amp (Sourcegraph)
~/.config/amp/settings.json or .amp/settings.json, carrying the same credential. The amp mcp CLI covers approve, doctor and oauth.
The key is `amp.mcpServers`, namespaced. A bare mcpServers block is ignored.
Cline
~/.cline/mcp.json per the docs. The source also reads ~/.cline/data/settings/cline_mcp_settings.json. Key mcpServers, standard JSON shape, carrying the same credential. Supports stdio, streamable HTTP and SSE.
Goose (Block)
~/.config/goose/config.yaml, carrying the same credential.
YAML, and servers are called `extensions`. Goose does not use the MCP vocabulary in config at all. Add one interactively with goose configure, or per session with goose session --with-extension.
Kiro (AWS)
.kiro/settings/mcp.json per workspace, or ~/.kiro/settings/mcp.json globally. Key mcpServers, standard JSON shape, carrying the same credential.
Warp
~/.warp/.mcp.json or .warp/.mcp.json. Key mcpServers, standard shape, carrying the same credential. Also addable through the /agent-add-mcp skill.
JetBrains Junie
.junie/mcp/mcp.json per project, or ~/.junie/mcp/mcp.json. Key mcpServers, carrying the same credential. Use /mcp in the CLI to manage.
Roo Code
.roo/mcp.json per project. The global file is mcp_settings.json, opened from the Roo Code MCP settings view with Edit Global MCP. Key mcpServers, carrying the same credential.
Continue
.continue/mcpServers/*.yaml, one file per server, carrying the same credential.
YAML, and `mcpServers` is a list, not an object. Every JSON client keys servers by name. Continue takes an array, so a converted config will not parse.
Trae
.trae/mcp.json per project, or paste into the UI under Raw Config (JSON). Key mcpServers, standard shape, carrying the same credential.
Devin
Devin has no config file to edit. Servers are added through a web form in the settings UI, and Devin's documentation states you do not need to write or paste JSON. The block below is the shape those fields describe, shown for reference. Either route uses the same credential.
Registering only some tools
The documented way to shrink the surface. The API key is unchanged; the extra header lists the exact tool names to enable.
claude mcp add --transport http respan \ https://mcp.respan.ai/mcp \ --header "Authorization: Bearer <your-respan-api-key>" \ --header "Respan-Enabled-Tools: list_logs,get_log_detail"
Read-only access, permissions and security
Prompts, prompt versions, evaluators, pipelines, workflows, datasets and logs can all be created or changed
Three of the nine categories are write categories.
One tool deploys
deploy_prompt_versionchanges what production serves, from the same connection that reads logs.Deletion is reachable
delete_evaluator,delete_datasetanddelete_experimentall appear in the documented list. The tool groups above do not reproduce every one of the 55;delete_experimentis one they omit.Traces carry prompt content
A trace tree includes the model calls it describes, so that content reaches the model reading it.
Troubleshooting
- The endpoint returns 401
- An unauthenticated request is rejected with an Unauthorized error. Pass the API key as a bearer token, or complete OAuth.
- Documentation cannot be found under Keywords AI
- The product is published as Respan. The MCP documentation lives under the Respan domain rather than the original brand.
- All 55 tools appear in the client
- All 55 tools register unless narrowed. Add the
Respan-Enabled-Toolsheader with the exact tool names you want. - Production behavior changed after a session
- Check for a deployment.
deploy_prompt_versionis in the default tool list.
Keywords AI MCP server: Reference
| Item | Value |
|---|---|
| Endpoint | mcp.respan.ai/mcp |
| Brand | Keywords AI now trades as Respan; docs are published under that name |
| Auth | API key as a bearer token, recommended; OAuth and a JWT fallback documented |
| Tools | 55 documented, across 9 categories |
| Scoping | Respan-Enabled-Tools header, comma-separated exact names |
| Deploying tools | deploy_prompt_version |
| Inventory source | The vendor's own MCP documentation, read 24 August 2026 |
What engineers report
The documentation lists tools in per-category tables, so the counts below are its own.
| What was checked | What it shows |
|---|---|
| Documented tools | 55 |
| Documented categories | 9 |
| Authentication routes | 3: API key, OAuth and a JWT fallback |
| Scoping mechanism | Respan-Enabled-Tools header |
| Deploying tools | 1 |
Tool inventory, authentication routes and the scoping header read from the vendor's own MCP documentation on 24 August 2026, published under the Respan name. An unauthenticated tools/list against mcp.respan.ai/mcp returned 401 on the same date.
Should you connect an agent to Keywords AI?
Yes. Best for a scoped enabled-tools list per session, with deploy_prompt_version left out unless deploying is intended.
- Strongest fit
- Teams already tracing model calls with this platform who want prompt and evaluation work inside the editor.
- Main advantage
- A documented header for registering only the tools a session needs, which few connectors here provide.
- Main weakness
- The rename means most existing references point at a brand the documentation no longer uses.
- Operational risk
- Deployment and deletion tools register by default alongside the reading ones.
From Oodle
One platform for agent traces and infrastructure
Agent traces usually sit in a different product from the rest of your telemetry, so when a slow database makes an agent slow the symptom is in one tool and the cause is in another. Oodle keeps both in one query surface, from $10 per million spans.
See agent observabilityFrequently asked questions
How many tools does the Keywords AI MCP server have?
55 documented across nine categories, read from the vendor's own documentation on 24 August 2026, because the hosted endpoint returns 401 without credentials.
Why does the documentation say Respan?
Keywords AI now trades as Respan. The endpoint, the documentation and the scoping header all use that name.
Can I register fewer tools?
Yes. The Respan-Enabled-Tools header takes a comma-separated list of exact tool names. Omitting it makes all Platform MCP tools available.
How does authentication work?
An API key as a bearer token is the documented recommendation, with OAuth supported and a JWT token as the fallback.
Can an agent change production?
Yes. deploy_prompt_version changes what production serves, and several delete tools are in the default list.