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
| Tool | Description |
|---|---|
list_posts | List posts with optional filters for sorting, pagination, status, content type, and brand identity |
get_post | Get a single post by ID |
update_post | Update a post's title, markdown, or status |
delete_post | Delete a post |
generate_post | Queue async post generation from GitHub activity |
get_post_generation_status | Check the status of a post generation job |
Brand Identities
| Tool | Description |
|---|---|
list_brand_identities | List all brand identities |
get_brand_identity | Get a single brand identity by ID |
update_brand_identity | Update brand identity settings |
delete_brand_identity | Delete a brand identity |
generate_brand_identity | Queue async brand identity generation from a website URL |
get_brand_identity_generation_status | Check the status of a brand identity generation job |
Integrations
| Tool | Description |
|---|---|
list_integrations | List all connected integrations (GitHub, Slack, Linear) |
create_github_integration | Connect a GitHub repository |
delete_integration | Delete a GitHub or Linear integration |
Schedules
| Tool | Description |
|---|---|
list_schedules | List scheduled content generation jobs |
create_schedule | Create a scheduled content generation job |
update_schedule | Update a scheduled content generation job |
delete_schedule | Delete a scheduled content generation job |
Chats
| Tool | Description |
|---|---|
list_chats | List chat sessions |
get_chat | Get a single chat with messages |
get_chat_by_external_channel | Get a chat by Discord or Slack channel ID |
create_chat | Start a new chat and return the streamed reply |
post_chat_message | Post a message to an existing chat and return the streamed reply |
Skills
| Tool | Description |
|---|---|
list_skills | List reusable writing skills |
get_skill | Get a single skill by name |
create_skill | Create a reusable writing skill |
update_skill | Update a reusable writing skill |
delete_skill | Delete a reusable writing skill |