> For the complete documentation index, see [llms.txt](https://docs.gradient.works/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gradient.works/kb/api-and-mcp/overview.md).

# Overview

Gradient Works provides two ways to connect external tools to your account:

**API** — for programmatic, deterministic access. Use API keys to build scripts, integrations, and automated workflows that call Gradient Works directly. Full API reference documentation is available at [agents.gradient.works/api/docs](https://agents.gradient.works/api/docs/).

**MCP** — for AI agents. Connect Claude, ChatGPT, or other MCP-compatible AI assistants so they can read and act on your Gradient Works data in real time. The MCP server URL is:

```
https://agents.gradient.works/mcp
```

## Access levels

Both API keys and MCP connections use the same two access levels:

|                        | Read-only | Full access |
| ---------------------- | --------- | ----------- |
| View and query data    | ✓         | ✓           |
| Create and update data | —         | ✓           |

**Read-only** is appropriate for most AI assistant connections — it lets your AI see your data and answer questions without the ability to make changes.

**Full access** allows creating and updating records. Use this when you need to automate writes, such as a script that runs distributions or creates market maps.

How the access level is assigned depends on the connection type:

* **API keys:** you choose the access level when you create the key.
* **MCP connections:** the access level you can grant is capped by your user role. **Admins can choose read-only or full access; all other users can connect read-only only.** You can't grant an MCP connection more access than your own role allows.

## Revoking access

You can revoke access at any time and it takes effect immediately:

* API keys: **Company Settings → API Keys → Revoke**
* MCP connections: **Company Settings → Connections → Disconnect**

See [API Keys & Connections](/kb/api-and-mcp/api-keys.md) for step-by-step instructions.

## Getting started

* [API Keys & Connections](/kb/api-and-mcp/api-keys.md)
* [Setup: Claude Desktop/Web](/kb/api-and-mcp/setup_claude.md)
* [Setup: ChatGPT](/kb/api-and-mcp/setup_chatgpt.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gradient.works/kb/api-and-mcp/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.