Back to Integrations
AI Agent Integration

Herald + AI / MCP

Herald exposes a Model Context Protocol (MCP) endpoint that lets AI agents browse documentation, search for topics, and retrieve copy-paste ready code — making integration faster. Configure Claude Desktop or Cursor to use the Herald MCP server and get AI-assisted integration support.

Ready to ship?

Start sending zero-PII notifications in minutes.

REGISTER YOUR WALLET
ZK-SECURE SOLANA NATIVE

Package: N/A

Install: See docs above

Claude Desktop Configuration

Add to claude_desktop_config.json to enable the Herald MCP server.

1
2
3
4
5
6
7
8
{
  "mcpServers": {
    "herald-docs": {
      "type": "url",
      "url": "https://useherald.xyz/api/mcp"
    }
  }
}

Cursor Configuration

Add MCP server in Cursor settings.

1
2
3
// Cursor > Settings > Features > MCP Servers
// Add new server with URL:
// https://useherald.xyz/api/mcp

Available MCP Tools

Four tools exposed by the Herald MCP endpoint.

1
2
3
4
get_herald_context    — Full protocol overview & architecture
search_herald_docs   — Search docs by keyword (query, maxResults)
get_integration_example — Copy-paste code (backend, serverless, webhook, batch)
get_doc_page         — Read a doc page by slug (e.g., sdk/typescript)

Test via curl

Verify the MCP endpoint with a tools/list call.

1
2
3
4
5
6
7
8
9
# List all available tools
curl -X POST https://useherald.xyz/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'


# Get integration example for webhooks
curl -X POST https://useherald.xyz/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_integration_example","arguments":{"pattern":"webhook"}}}'

Common Patterns

AI-assisted SDK integration with Claude Desktop
Cursor IDE with inline MCP tool calls
Search Herald docs programmatically via API
Retrieve copy-paste code snippets for any pattern

Start building with Herald

Clone the examples repo, copy the code that fits your stack, and deploy.

VIEW ON GITHUBREAD DOCS