Documentation

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:

  1. Create websites and update website profiles.
  2. Add backlinks to a website queue by tag, recommended package, or category.
  3. Bulk add backlinks by URL or backlink ID.
  4. Generate the Codex auto-submission prompt for a website.
  5. Check the submission progress of a website.
  6. Review backlink submissions across every website in your account.

Before you start

  1. Open API Keys and create an active API key (it starts with sk_).
  2. 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

ToolPurpose
list_websitesList all websites in your account and the website quota
get_websiteRead a website's full profile and profile check result
create_websiteCreate a website; product_name and product_url are required
update_websiteUpdate a website; pass only the fields you want to change
add_backlinks_by_tagsAdd backlinks to a website by tag, recommended package, or category
batch_add_backlinksBulk add by backlink URL or ID, up to 3,000 per call
get_codex_submission_promptGenerate the Codex auto-submission prompt with the API document
get_website_submission_progressRead a website's status counts and submission records
get_account_backlink_overviewRead 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

  1. A Codex prompt cannot be generated until the website has a name, URL, and short description.
  2. 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.
  3. Website and backlink limits follow your current plan, the same as in the web app.
  4. See Automated backlinks with Codex for the full Codex workflow.