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

# MCP Server

> Connect the Notra MCP server to AI tools using OAuth or API-key bearer authentication, with tools for posts, brand identities, integrations, and schedules.

Notra provides a hosted MCP server at `https://mcp.usenotra.com/mcp` so AI agents can work with your Notra workspace directly.

With the MCP server connected, an AI agent can manage your brand identity, create content for you, add or remove integrations, and manage scheduled generation without you having to wire everything up by hand.

## Authentication

The MCP server accepts bearer credentials in the `Authorization` header.
OAuth clients, including ChatGPT Apps, can start with the protected resource
metadata endpoint:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://mcp.usenotra.com/.well-known/oauth-protected-resource
```

That metadata advertises the OAuth authorization server, supported scopes, and
supported bearer-token method.

Clients that do not support OAuth discovery can use a Notra API key:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Authorization: Bearer YOUR_API_KEY
```

Create and manage API keys in [Authentication](/api/authentication).

<img src="https://mintcdn.com/notra/61y0WT4n5c9L1YWx/images/api/api-keys-light.webp?fit=max&auto=format&n=61y0WT4n5c9L1YWx&q=85&s=1fa24983d8adeb0523097591b1e698a5" alt="Create an API key with read & write permissions for MCP" className="block dark:hidden" width="2284" height="1518" data-path="images/api/api-keys-light.webp" />

<img src="https://mintcdn.com/notra/61y0WT4n5c9L1YWx/images/api/api-keys-dark.webp?fit=max&auto=format&n=61y0WT4n5c9L1YWx&q=85&s=3be3c3f0863ee159b243b13264fefb39" alt="Create an API key with read & write permissions for MCP" className="hidden dark:block" width="2284" height="1518" data-path="images/api/api-keys-dark.webp" />

<Tip>
  For manual API-key connections, grant read and write access for the resources
  your MCP client should manage, such as posts, brand identities, integrations,
  schedules, chats, and skills.
</Tip>

## Install

### `add-mcp` (Recommended)

If your client supports [`add-mcp`](https://www.npmjs.com/package/add-mcp), you can install the server with a header override:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npx add-mcp https://mcp.usenotra.com/mcp --header "Authorization: Bearer $TOKEN"
```

<Tip>
  Set `TOKEN` to a Notra API key before running the command.
</Tip>

### Manual installation

Add something like this to your MCP client config:

<CodeGroup>
  ```json opencode.json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  "notra": {
    "type": "remote",
    "url": "https://mcp.usenotra.com/mcp",
    "enabled": true,
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
  ```

  ```json mcp.json (Cursor) theme={"theme":{"light":"github-light","dark":"github-dark"}}
  "notra": {
    "url": "https://mcp.usenotra.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
  ```

  ```json claude.json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  "notra": {
    "type": "http",
    "url": "https://mcp.usenotra.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
  ```
</CodeGroup>

## Available tools

Once installed, the Notra MCP server currently exposes these tools:

**Posts**

* `notra_list_posts`
* `notra_get_post`
* `notra_update_post`
* `notra_delete_post`
* `notra_generate_post`
* `notra_get_post_generation_status`

**Brand identities**

* `notra_list_brand_identities`
* `notra_get_brand_identity`
* `notra_update_brand_identity`
* `notra_delete_brand_identity`
* `notra_generate_brand_identity`
* `notra_get_brand_identity_generation_status`

**Integrations**

* `notra_list_integrations`
* `notra_create_github_integration`
* `notra_delete_integration`

**Schedules**

* `notra_list_schedules`
* `notra_create_schedule`
* `notra_update_schedule`
* `notra_delete_schedule`

**Chats**

* `notra_list_chats`
* `notra_get_chat`
* `notra_get_chat_by_external_channel`
* `notra_create_chat`
* `notra_post_chat_message`

**Skills**

* `notra_list_skills`
* `notra_get_skill`
* `notra_create_skill`
* `notra_update_skill`
* `notra_delete_skill`

## Composio

If you want to use the Notra MCP server with [Composio](https://composio.dev/), please upvote our request at [request.composio.dev/boards/tool-requests/posts/notra](https://request.composio.dev/boards/tool-requests/posts/notra).

That helps the Composio team see demand for a Notra integration and prioritize it on their roadmap.

## Notes

* Use a server-side or local-secret store for your API key.
* Do not commit MCP config files that contain live bearer tokens.
* Revoke and replace the key immediately if it is exposed.