What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI tools connect to external services. Coffee & Contracts provides an MCP server so you can access your content library, calendar, events, and more directly from AI assistants like Claude, Cursor, Windsurf, and other MCP-compatible tools.

This means you can ask your AI assistant things like:

"What content is scheduled for this week?"
"Show me today's content drop"
"Search for posts about open houses"
"What events are coming up?"

Prerequisites

You need:

An active Coffee & Contracts subscription
An API key (starts with cc_)

Creating an API Key

If you don't have an API key yet, you can create one from the API Keys section in your account settings, or by following the API Developer Guide.

When creating your key, make sure to include these scopes for full MCP access:

content:read — Browse posts, content types, and pillars
calendar:read — View your content schedule and daily tasks
search:read — Search across posts and events
account:read — View your profile

Connecting to the MCP Server

Server URL

https://api.coffeecontracts.com/mcp

Claude Desktop / Claude Code

Add this to your MCP configuration file (claude_desktop_config.json or .claude.json):

{
  "mcpServers": {
    "coffee-and-contracts": {
      "type": "url",
      "url": "https://api.coffeecontracts.com/mcp",
      "headers": {
        "Authorization": "Bearer cc_YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor / Windsurf / Other MCP Clients

Use the same server URL and authorization header. Refer to your tool's documentation for where to add MCP server configurations. The key details are:

URL: https://api.coffeecontracts.com/mcp
Transport: Streamable HTTP (POST)
Auth Header: Authorization: Bearer cc_YOUR_API_KEY_HERE

Available Tools

Once connected, your AI assistant will have access to these tools:

Tool	What It Does
`get_posts`	Browse and filter the content library by type, pillar, date, or search term. Get trending posts.
`get_post`	Get full details of a specific post including caption, instructions, photos, and Canva link.
`get_content_calendar`	View your content schedule for a date, date range, or month.
`get_content_drops`	See this week's (or any month's) new content drops.
`get_trending_reels`	Get the trending reels and posts for this week.
`get_events`	List upcoming workshops, trainings, and live sessions.
`get_daily_tasks`	Get your daily social media task.
`search_content`	Search across all posts and events by keyword.
`get_my_profile`	View your profile information.
`list_content_types`	See all content types (Reel, Carousel, Static Post, etc.).
`list_content_pillars`	See all content pillars (topic categories).

Example Conversations

Once connected, you can have natural conversations with your AI assistant:

Planning your week:

"What's on my content calendar for this week? Can you suggest which posts to prioritize?"

Finding content:

"Find me a carousel post about staging tips"

Staying current:

"What's new in this week's content drop?"

Getting organized:

"What's my daily task today, and what events are coming up this week?"

Rate Limits

The MCP server uses your API key, which has the following rate limits:

30 requests per minute
500 requests per hour
2,000 requests per day

Normal AI assistant usage will stay well within these limits.

Troubleshooting

"Invalid API key" error: Make sure your key starts with cc_ and is correctly pasted in the config. API keys are only shown once when created.

"Active subscription required" error: The MCP server requires an active Coffee & Contracts subscription.

"API key missing required scope" error: Your API key doesn't have the right permissions. Create a new key with the scopes listed above.

Tool not working in Claude Cowork: Make sure you're using the remote MCP configuration (with a URL), not a local stdio configuration.

If you're still having trouble, reach out to us through the chat widget and we'll help you get set up!

Connect Coffee & Contracts to AI Tools with MCP