# Developer & AI tools

The Agility Credit docs are built for AI-assisted development. Connect Claude, Cursor or VS Code with the [MCP server](#mcp-server), or give any assistant the [Markdown docs and llms.txt](#docs-for-ai-assistants). It then reads the same endpoints, schemas and error codes you do, so the code it writes matches the real API.

You'll also find the [OpenAPI spec](#openapi-spec) and a ready-to-use [Postman collection](#postman-collection).

## OpenAPI spec

| File | Use it for |
| --- | --- |
| [`openapi.yaml`](pathname:///openapi.yaml) | The full API: generate clients, import into API tools, validate requests. |
| [`agc-scim-openapi.yaml`](pathname:///agc-scim-openapi.yaml) | The SCIM provisioning API. |

You can also download the spec from **Export** on the [API reference overview](https://apidocs.agilitycredit.com/api).

## Postman collection

[Download the Postman collection](pathname:///agility-credit-api.postman_collection.json), then in Postman choose **Import** and drop in the file.

1. Open the collection's **Variables** tab.
2. Set `apiKey`, `tenantId` and `userId`. Agility Credit provides your tenant ID and first user ID; create API keys in the portal under **Settings → Account → API Keys**.
3. `baseUrl` is set to production. For UAT, change it to `https://api.agc-dev.com/v3` and use your UAT key (UAT and production use separate keys).

Every request reuses those variables, and each `POST` sends a fresh `Idempotency-Key`. Request bodies contain placeholder values only.

## Docs for AI assistants

The docs are available as plain Markdown, so AI assistants and tools that don't run JavaScript get the full reference, including parameters and schemas.

| URL | What it is |
| --- | --- |
| [`/llms.txt`](pathname:///llms.txt) | An index of every page, following the [llms.txt](https://llmstxt.org) convention. |
| [`/llms-full.txt`](pathname:///llms-full.txt) | The whole documentation in one file. Paste it into a chat or a project's knowledge. |
| Any page URL + `.md` | The Markdown version of that page, for example [`/api/make-inquiry.md`](pathname:///api/make-inquiry.md). |

## MCP server

The Agility Credit docs MCP server lets assistants that support the [Model Context Protocol](https://modelcontextprotocol.io), such as Claude, Cursor and VS Code, look up endpoints, schemas, headers and errors while you work.

It is **read-only**: it reads the published OpenAPI spec and never calls the Agility Credit API. It needs no API key and sends no data anywhere except to fetch the spec from this site. It requires [Node.js](https://nodejs.org) 18 or later.

**Claude Code**

```bash
claude mcp add agility-credit-docs -- npx -y @agilitycredit/docs-mcp
```

**Claude Desktop, Cursor** (`claude_desktop_config.json` or `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "agility-credit-docs": {
      "command": "npx",
      "args": ["-y", "@agilitycredit/docs-mcp"]
    }
  }
}
```

**VS Code** (`.vscode/mcp.json`):

```json
{
  "servers": {
    "agility-credit-docs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@agilitycredit/docs-mcp"]
    }
  }
}
```

The package is [`@agilitycredit/docs-mcp`](https://www.npmjs.com/package/@agilitycredit/docs-mcp) on npm.

| Tool | What it does |
| --- | --- |
| `list_endpoints` | Lists endpoints, optionally filtered by tag or keyword. |
| `get_endpoint` | Full details for one endpoint: headers, request body, responses. |
| `get_schema` | A named schema with references resolved. |
| `search_api` | Keyword search across endpoints and schemas. |
| `get_platform_basics` | Environments, authentication, common headers, rate limits and error codes. |

Then ask your assistant things like *"Which headers does `POST /credit-reports` need?"* or *"Write a Python function that runs an OFAC check."*

Source: https://apidocs.agilitycredit.com/developer-tools