> ## Documentation Index
> Fetch the complete documentation index at: https://docs.awardforce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Docs MCP

> Connect AI tools to the Award Force API documentation using the Model Context Protocol.

## Overview

The Award Force docs MCP server gives any [MCP](https://modelcontextprotocol.io)-compatible AI tool a direct connection to the Award Force API documentation. Instead of guessing how the API works, the AI searches the docs and grounds its answers in current content.

**Without the docs MCP:**

```
You: "List all entries in a season"
AI: *generates code that might use the wrong endpoint*
```

**With the docs MCP:**

```
You: "List all entries in a season"
AI: *searches Award Force docs automatically*
AI: *generates code using the correct endpoint*
```

## How it helps you

When you connect the docs MCP to your AI tools, the AI becomes an Award Force expert and:

* Generates accurate code using current API endpoints, parameters, and request bodies.
* Answers specific questions about the API, authentication, and webhooks.
* Suggests best practices for working with entries, categories, assignments, and more.
* Finds the right documentation when you are stuck on implementation.

<Note>
  The docs MCP server provides documentation `search` only. It does not make API calls. To use the Award Force API itself, include your API key in requests as described in the [authentication guide](/docs/authentication/index).
</Note>

## Server URL

```
https://docs.awardforce.com/mcp
```

Add this URL to any MCP-compatible client. Most clients accept either a URL-based remote MCP server or a manual entry in their MCP configuration file.

## Configuration

### URL-based connection

If your client supports remote MCP servers, paste the server URL into its connector settings.

### File-based configuration

If your client uses an `mcp.json` (or equivalent) configuration file, add an entry like:

```json theme={null} theme={null}
{
  "mcpServers": {
    "Award Force": {
      "url": "https://docs.awardforce.com/mcp"
    }
  }
}
```

### One-click connectors

Many Award Force documentation pages include one-click MCP connectors in the dropdown next to the document header. See [AI-optimised documentation](/docs/additional/ai-optimized-documentation) for details.

## Test your MCP connection

Once configured, verify the connection by asking your AI tool:

```
What MCP tools do you have available?
```

You should see the Award Force documentation search tool listed. Then try:

```
Search the Award Force docs for information about entries
```

The AI searches and returns relevant Award Force documentation.

## Troubleshooting

### Connection issues

MCP server not connecting:

* Verify the URL is exactly `https://docs.awardforce.com/mcp`.
* Check your internet connection.
* Restart your AI tool after configuration.

Search tool not available:

* Confirm the MCP server was added correctly.
* Try removing and re-adding the server configuration.
* Check the MCP support documentation for your AI tool.

### Search issues

Search returns no results:

* Try different search terms.
* Use more general terms, for example `entry` instead of `entry field API`.
* Verify the MCP connection is working.

## Additional resources

* [Model Context Protocol documentation](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server)
* [Mintlify MCP documentation](https://mintlify.com/docs/ai/model-context-protocol)
* [AI-optimised documentation](/docs/additional/ai-optimized-documentation)

## Disclaimer

AI agents make errors, misinterpret instructions, or produce inaccurate output. Award Force does not guarantee the accuracy of any information retrieved or action taken by an AI agent using this MCP server. You are solely responsible for reviewing and verifying any API requests or code generated through agentic workflows.