MCP integration guide
What it does
Submify provides an MCP (Model Context Protocol) server. Once connected, you can work from any MCP-capable AI tool such as Codex, Claude Code, or Cursor:
- Create websites and update website profiles.
- Add backlinks to a website queue by tag, recommended package, or category.
- Bulk add backlinks by URL or backlink ID.
- Generate the Codex auto-submission prompt for a website.
- Check the submission progress of a website.
- Review backlink submissions across every website in your account.
Before you start
- Open API Keys and create an active API key (it starts with sk_).
- An AI tool that supports remote MCP (Streamable HTTP), such as Codex, Claude Code, or Cursor.
MCP endpoint:
https://submify.app/api/mcp
Every request must include the header Authorization: Bearer <your API key>. Your API key is an account credential. Do not share it publicly, and disable and recreate it right away if you suspect a leak.
1. Connect Codex
Add this to ~/.codex/config.toml:
[mcp_servers.submify]
url = "https://submify.app/api/mcp"
bearer_token_env_var = "SUBMIFY_API_KEY"
Then set the environment variable in the terminal that starts Codex:
export SUBMIFY_API_KEY="sk_xxx"
2. Connect Claude Code
Run:
claude mcp add --transport http submify https://submify.app/api/mcp \
--header "Authorization: Bearer sk_xxx"
3. Connect Cursor and other tools
Add this to the tool's MCP config file (for Cursor, ~/.cursor/mcp.json):
{
"mcpServers": {
"submify": {
"url": "https://submify.app/api/mcp",
"headers": {
"Authorization": "Bearer sk_xxx"
}
}
}
}
Restart the tool. When submify and the tools below appear in the MCP list, the connection is ready.
4. Available tools
| Tool | Purpose |
|---|---|
| list_websites | List all websites in your account and the website quota |
| get_website | Read a website's full profile and profile check result |
| create_website | Create a website; product_name and product_url are required |
| update_website | Update a website; pass only the fields you want to change |
| add_backlinks_by_tags | Add backlinks to a website by tag, recommended package, or category |
| batch_add_backlinks | Bulk add by backlink URL or ID, up to 3,000 per call |
| get_codex_submission_prompt | Generate the Codex auto-submission prompt with the API document |
| get_website_submission_progress | Read a website's status counts and submission records |
| get_account_backlink_overview | Read total, in-progress, done, and failed counts for every website |
Backlinks already attached to the website are skipped automatically, and invalid URLs are listed in the result.
5. Example prompts
Create a website for https://example.com named Example, described as "an AI writing tool".
Add all backlinks tagged startup and in the directory category to the Example website.
Generate the Codex submission prompt for Example, directories only, up to 20 tasks.
Show the submission progress for Example and list the records that need my attention.
Summarize backlink submissions across all my websites.
Notes
- A Codex prompt cannot be generated until the website has a name, URL, and short description.
- When you connect with an API key, the generated prompt includes that key so Codex can run it directly. Do not share the prompt publicly.
- Website and backlink limits follow your current plan, the same as in the web app.
- See Automated backlinks with Codex for the full Codex workflow.