Notra MCP Server

Notra MCP Server

An MCP (Model Context Protocol) server that provides LLM clients with full access to the Notra API for managing posts, brand identities, integrations, and schedules.

Setup

You can generate an API key from your Notra workspace dashboard under Developer > API Keys.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notra": {
      "command": "npx",
      "args": ["-y", "@usenotra/mcp"],
      "env": {
        "NOTRA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add notra -- npx -y @usenotra/mcp

Then set the NOTRA_API_KEY environment variable in your shell before launching Claude Code.

Remote MCP (OAuth)

The hosted streamable HTTP server at https://mcp.usenotra.com/mcp uses OAuth as the primary authentication method. MCP clients should discover protected resource metadata at:

https://mcp.usenotra.com/.well-known/oauth-protected-resource

That metadata points to the Notra authorization server at https://app.usenotra.com/.well-known/oauth-authorization-server, which supports dynamic client registration (RFC 7591).

API key alternative

Remote connections also accept a Notra API key as a static Authorization: Bearer … header. Generate one from your Notra workspace dashboard under Developer > API Keys. OAuth-capable clients should prefer the OAuth flow instead of manual key configuration.

For self-hosted HTTP deployments, OAuth validation can be configured with:

NOTRA_OAUTH_ISSUER=https://app.usenotra.com/api/auth
NOTRA_OAUTH_JWKS_URL=https://app.usenotra.com/api/auth/jwks
NOTRA_MCP_RESOURCE=https://mcp.usenotra.com

The issuer must match the iss claim in tokens minted by the authorization server (https://app.usenotra.com/api/auth); a mismatch causes every bearer token to be rejected.

When NODE_ENV=development, the default issuer is http://localhost:3000/api/auth; production defaults to https://app.usenotra.com/api/auth.

Tools

Posts

Brand Identities

Integrations

Schedules

Chats

Skills