Skip to main content
Give your AI assistant direct access to Ark’s documentation. Instead of outdated training data or generic web searches, your AI gets real-time, authoritative answers from our docs.
Two MCP Servers, Different Purposes
ServerWhat It DoesUse Case
Docs MCP (this page)Searches Ark documentationGet accurate answers about how to use Ark
API MCPSends emails, manages domains, checks deliveriesActually send emails and manage your account
Most users want both: Docs MCP for learning, API MCP for doing.

​
Why Use the Docs MCP?

When you ask an AI assistant about Ark without this connection, it relies on:
  • Training data that may be months or years old
  • Generic web searches that return blog posts and Stack Overflow
  • Guesses based on similar APIs
With the Docs MCP connected, your AI assistant:
  • Searches our documentation in real-time
  • Returns accurate, up-to-date information
  • Links directly to relevant documentation pages
  • Understands Ark-specific terminology and patterns

​
Quick Setup

​
Claude Code

Run this command to connect Ark’s documentation to Claude Code: 
claude mcp add --transport http ark-docs https://arkhq.io/docs/mcp
Verify the connection: 
claude mcp list
You should see ark-docs listed with status “connected”.

​
Claude Desktop

1

Open Claude Settings

Navigate to Settings > Connectors in Claude Desktop
2

Add Custom Connector

Click Add custom connector and enter:
  • Name: Ark Docs
  • URL: https://arkhq.io/docs/mcp
3

Enable the Connector

When chatting, click the + button and select Ark Docs to enable it for that conversation

​
Cursor

Install in Cursor

​
VS Code

Install in VS Code

​
Windsurf

Add to your Windsurf MCP configuration: 
{
  "mcpServers": {
    "ark-docs": {
      "url": "https://arkhq.io/docs/mcp"
    }
  }
}

​
Other MCP Clients

The Docs MCP server is available at: 
https://arkhq.io/docs/mcp
Use HTTP transport. No authentication required.

​
What You Can Ask

Once connected, your AI assistant can answer questions like:

Getting Started

“How do I send my first email with Ark?”
“What SDKs does Ark support?”
“How do I set up my sending domain?”
“What’s the quickest way to integrate Ark into my Node.js app?”
“What parameters does the send email endpoint accept?”
“How do I check if an email was delivered using Python?”
“What’s the difference between send and send_batch?”
“Show me how to handle webhooks in Go”
“What DNS records do I need for DKIM?”
“How do I verify my sending domain?”
“What’s the difference between SPF and DMARC?”
“Why is my domain showing as unverified?”
“What does a soft bounce mean?”
“How do I handle suppression lists?”
“Why might emails go to spam?”
“What are Ark’s rate limits?”
“What webhook events does Ark send?”
“How do I verify webhook signatures?”
“What’s the payload format for bounce events?”
“How do I test webhooks locally?”

​
Example Conversations

​
Learning the API

​
Debugging Issues

​
Available Tools

The Docs MCP exposes one tool to AI assistants:
ToolDescription
SearchArkEmailApiSearch across all Ark documentation including API references, SDK guides, concepts, and troubleshooting
The search returns:
  • Relevant documentation excerpts
  • Page titles and URLs
  • Context around matches

​
How It Works

You ←→ AI Assistant ←→ Docs MCP Server ←→ Ark Documentation
  1. You ask a question about Ark
  2. Your AI assistant calls the SearchArkEmailApi tool
  3. The MCP server searches our indexed documentation
  4. Relevant results are returned to your AI assistant
  5. Your AI formulates an accurate answer with documentation links
No API key required. The Docs MCP only searches public documentation.

​
Combine with the API MCP

For the full Ark AI experience, use both MCP servers together: 
{
  "mcpServers": {
    "ark-docs": {
      "url": "https://arkhq.io/docs/mcp"
    },
    "ark-email": {
      "command": "npx",
      "args": ["-y", "ark-email-mcp"],
      "env": {
        "ARK_API_KEY": "ark_live_your_key_here"
      }
    }
  }
}
Now your AI assistant can:
  • Learn how to do things (Docs MCP)
  • Do the things (API MCP)
Example workflow:
“How do I send a batch email with Ark?” → Docs MCP explains the API “Send a welcome email to these 5 addresses…” → API MCP executes the request

​
FAQ

Yes. The Docs MCP searches documentation and returns information. The API MCP actually sends emails and manages your account.Think of it as: Docs MCP teaches, API MCP does.
No. The Docs MCP only searches public documentation and doesn’t require authentication.The API MCP requires an API key because it performs actions on your account.
The Docs MCP searches our live documentation. When we update our docs, the MCP server immediately reflects those changes.
Any MCP client that supports HTTP transport:
  • Claude Desktop
  • Claude Code
  • Cursor
  • VS Code (with Claude extension)
  • Windsurf
  • Any custom MCP client
Yes. The endpoint https://arkhq.io/docs/mcp is publicly available. Connect any MCP-compatible client to give your AI access to Ark documentation.

​
Resources

API MCP Server

Send emails and manage your account with AI

MCP Protocol

Learn about the Model Context Protocol standard

Quickstart

Send your first email in 5 minutes

API Reference

Explore all API endpoints