MCP Server

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:

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:

Authorization: Bearer YOUR_API_KEY

Create and manage API keys in Authentication.

Create an API key with read & write permissions for MCP

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.

Install

`add-mcp` (Recommended)

If your client supports add-mcp, you can install the server with a header override:

npx add-mcp https://mcp.usenotra.com/mcp --header "Authorization: Bearer $TOKEN"

Tip

Set TOKEN to a Notra API key before running the command.

Manual installation

Add something like this to your MCP client config:

opencode.jsonmcp.json (Cursor)claude.json

"notra": {  "type": "remote",  "url": "https://mcp.usenotra.com/mcp",  "enabled": true,  "headers": {    "Authorization": "Bearer YOUR_API_KEY"  }}

"notra": {  "url": "https://mcp.usenotra.com/mcp",  "headers": {    "Authorization": "Bearer YOUR_API_KEY"  }}

"notra": {  "type": "http",  "url": "https://mcp.usenotra.com/mcp",  "headers": {    "Authorization": "Bearer YOUR_API_KEY"  }}

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, please upvote our request at 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.