PostcardAI MCP Server

#!/usr/bin/env node

/**
 * PostcardAI MCP Server
 *
 * Model Context Protocol server enabling AI assistants to interact with PostcardAI.
 * Provides tools for creating mailings, managing contacts, generating designs, and more.
 *
 * @see https://docs.postcard.ai/ai-integrations
 */

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

import {
  registerAccountTools,
  registerCreditsTools,
  registerContactsTools,
  registerListsTools,
  registerMailingsTools,
  registerDesignsTools,
  registerBrandsTools,
  registerReturnAddressesTools,
} from './tools/index.js';

// Create MCP server instance
const server = new McpServer({
  name: 'postcardai',
  version: '0.1.0',
});

// Register all tool modules
registerAccountTools(server);
registerCreditsTools(server);
registerContactsTools(server);
registerListsTools(server);
registerMailingsTools(server);
registerDesignsTools(server);
registerBrandsTools(server);
registerReturnAddressesTools(server);

async function main() {
  // Validate API key is configured
  if (!process.env.POSTCARDAI_API_KEY) {
    console.error('Error: POSTCARDAI_API_KEY environment variable is required.');
    console.error('Get your API key from https://app.postcard.ai/settings/api');
    process.exit(1);
  }

  // Connect to stdio transport
  const transport = new StdioServerTransport();
  await server.connect(transport);

  console.error('PostcardAI MCP server started');
  console.error(`API URL: ${process.env.POSTCARDAI_API_URL || 'https://api.postcard.ai/v1'}`);
}

main().catch((error) => {
  console.error('Fatal error starting MCP server:', error);
  process.exit(1);
});