> For the complete documentation index, see [llms.txt](https://docs.insert.link/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.insert.link/mcp-server-technical-reference.md). # MCP Server - Technical Reference Server URL: Transport: Streamable HTTP Authentication: OAuth 2.0 ### Canonical name mapping | MCP tool name | Product/UI name | | ------------------------------ | ------------------------------------------ | | search\_inserts | Search | | search\_insert\_pages | Search site | | search\_backlinks | Anchor text lookup | | search\_backlinks\_gap | Backlink Gap | | referring\_backlinks | Backlink Lookup | | domain\_lookup | Domain lookup | | search\_guest\_posts | Guest Post | | list\_categories | (internal helper, no direct UI equivalent) | | get\_cart | View Cart | | add\_guest\_post\_to\_cart | Add to Cart (Guest Post) | | add\_link\_insertion\_to\_cart | Add to Cart (Link Insertion) | ### Read-only tools #### list\_categories Returns the full site-content-category taxonomy as {id, path} pairs. The static list of category ids that the topical filters of other tools accept – content\_category in search\_guest\_posts, pcat in search\_inserts and search\_insert\_pages. #### search\_guest\_posts (Guest Post) Browse the catalog of websites available for guest posts. All filters optional. If no filters are applied, the tool returns the full catalog available to your account. | Parameter | Type | Description | | ----------------------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | tld | array\[string] | Top-level domains – large enumerated list (200+ values, e.g. .com, .io, .ua) matching the platform's tracked domain set | | niches / exclude\_niches | array\[string] | Niche names to include / exclude: Betting, CBD, Crypto, Dating, iGaming, Legal, Medicine, Trading, Forex, Vape | | languages | array\[string] | Site languages as ISO codes, e.g. \["en", "de"] | | search | string |

root domain query, e.g. "example.com"


| | top\_countries | array\[string] | ISO country codes for top-traffic country | | dr\_min / dr\_max | integer | Ahrefs Domain Rating | | rd\_min / rd\_max | integer | Referring domains | | traffic\_min / traffic\_max | integer | Organic traffic | | price\_min / price\_max | integer | Guest post price | | tf\_min / tf\_max | integer | Majestic Trust Flow | | cf\_min / cf\_max | integer | Majestic Citation Flow | | spam\_score\_min / spam\_score\_max | integer | Moz Spam Score | | domain\_authority\_min / domain\_authority\_max | integer | Moz Domain Authority | | authority\_score\_min / authority\_score\_max | integer | Semrush Authority Score | | ai\_overview\_reference\_min / ai\_overview\_reference\_max | integer | Keywords where Google AI Overview cites the domain | | age\_min / age\_max | integer | Domain age, in months | | content\_category | array\[string] | Primary category ids, from list\_categories | | fast\_delivery | boolean | Sites offering fast delivery | | ordering | string | One of: domain, dr, refdomains, keywords, org\_traffic, price, backlinks, language, country, spam\_score, domain\_authority, tf, cf, authority\_score, ai\_overview\_reference, notes. Prefix - for descending | | page | integer | Default 1, min 1 | | page\_size | integer | Default 10, range 1–100 | #### search\_inserts (Link Insert) Search source sites available for link insertion by topic. Full-text topic search across sites. Results ranked by relevance. | Parameter | Type | Description | | --------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | q | string | keyword(s) query, e.g. "healthy meal delivery" | | exact | boolean | Match q as an exact phrase. Requires q | | niches / exclude\_niches | array\[string] | Same values as search\_guest\_posts | | pcat | array\[string] | Primary category ids, from list\_categories | | languages / tld / top\_countries | — | Same value sets as search\_guest\_posts | | dr\_min/max, rd\_min/max, traffic\_min/max | integer | Site-level metrics | | price\_min / price\_max | integer | Link-insert price | | tf\_min/max, cf\_min/max, spam\_score\_min/max, domain\_authority\_min/max, authority\_score\_min/max, ai\_overview\_reference\_min/max | integer | Same metrics set as search\_guest\_posts | | page\_traffic\_min / page\_traffic\_max | integer | Traffic of the matched page, not the whole site | | page\_keyword\_min / page\_keyword\_max | integer | Ranking keywords of the matched page | | page / page\_size | integer | Default 1 / default 10 (1–100) | | ordering | string | One of: domain\_rating, refdomains, traffic, spam\_score, domain\_authority, domain\_trust\_flow, domain\_citation\_flow, authority\_score, ai\_overview\_reference, page\_traffic, page\_keywords. Prefix - for descending | #### search\_backlinks (Anchor text lookup) Look up donor sites by backlink anchor text. Submit one or more anchors using exact-match or "contains" matching and get sites already linking with those anchors, including metrics and pricing. | Parameter | Type | Required | Description | | --------- | ----------------------- | ---------------- | ------------------------------------------------------------------------------------------------------- | | anchors | array\[string] | Yes (min 1 item) | Anchor texts to look up, e.g. \["best seo tools"] | | match | enum: exact \| contains | No | Default: exact | | ordering | string | No | One of: domain\_rating, refdomains, traffic, keywords, ai\_overview\_reference. Prefix - for descending | No inventory filters, no pagination – the provider caps the result set itself. Response includes: donor sites with their acceptors (other domains the same donor already links to), SEO metrics, and guest-post prices. #### domain\_lookup (Domain lookup) Look up referring sites for a list of 1–3 domains. Same response shape as search\_backlinks\_gap, but without target/competitor mechanics. | Parameter | Type | Required | Description | | ----------------- | -------------- | --------------- | --------------------------------------------------------- | | domains | array\[string] | Yes (1–3 items) | Domains to look up referring sites for | | ordering | string | No | Same fields as search\_backlinks, default -domain\_rating | | page / page\_size | integer | No | Default 1 / default 10 (1–100) | Validation: the schema enforces 1–3 domains at the protocol level (minItems / maxItems) – a call with 4 domains is rejected before it reaches the server, not silently truncated. #### search\_backlinks\_gap (Backlink Gap) Find link-building opportunities: donor sites linking to competitors. | Parameter | Type | Required | Description | | ------------------- | ------------------------------------------------------- | ----------------- | --------------------------------------------------- | | target\_domain | string | Yes | Your domain, e.g. "seo.ai" | | competitor\_domains | array\[string] | Yes (1–3 items) | Competitors to gap against | | mode | enum: best \| weak \| strong \| shared \| unique \| all | No (default best) | best = donors linking to competitors but not to you | | ordering | string | No | Same fields as above, default -domain\_rating | | page / page\_size | integer | No | Default 1 / default 10 (1–100) | #### referring\_backlinks (Backlink Lookup) Look up who links to a specific domain — its backlink profile. | Parameter | Type | Required | Description | | ----------------- | ------- | -------- | --------------------------------------------------------------------- | | domain | string | Yes | A single domain, e.g. "seo.ai" (not an array — unlike domain\_lookup) | | page / page\_size | integer | No | Default 1 / default 10 (1–100) | Response: referring pages linking to the domain, each with the anchor text used and the donor site's SEO metrics (domain rating, referring domains, traffic). #### search\_insert\_pages (Link Insert + Search site) Drill into a specific site's pages for link insertion. | Parameter | Type | Required | Description | | --------------------------------------- | -------------- | -------- | -------------------------------------------------------------- | | site\_id | UUID | Yes | Site id — take id from a search\_inserts result | | q | string | No | keyword(s) query, e.g. "best AI bots" | | exact | boolean | No | Exact-phrase match. Requires q | | pcat | array\[string] | No | Primary category ids, from list\_categories | | niches / exclude\_niches | array\[string] | No | Shapes which prices are returned per page | | price\_min / price\_max | integer | No | Link-insert price | | page\_traffic\_min / page\_traffic\_max | integer | No | Traffic of the specific page | | page\_keyword\_min / page\_keyword\_max | integer | No | Ranking keywords of the specific page | | page / page\_size | integer | No | Default 1 / default 10 (1–100) | | ordering | string | No | One of: page\_traffic, page\_keywords. Prefix - for descending | #### get\_cart Show current cart contents. Parameters: none. Response: links (link-insertion items) and guest\_posts (guest-post items), each with niche and current price, plus cart total. Empty cart: a valid result, not an error. ### Write tools ### add\_guest\_post\_to\_cart Add a site to the cart for a guest post. | Parameter | Type | Required | Description | | ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | host | string | Yes | Exact site host – take from a search\_guest\_posts (or any backlink/domain search) result | | niche\_name | string | No | Exact niche name (not an internal id); valid values listed on the niches field of search\_guest\_posts. Omitting it is valid – prices under the no-niche rate | Errors: unknown niche or host → explicit error. Scope: filed under the caller's default workspace. #### add\_link\_insertion\_to\_cart Add a page to the cart for link insertion. | Parameter | Type | Required | Description | | ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | | page\_url | string | Yes | Exact page URL – take from a search\_inserts or search\_insert\_pages result | | niche\_name | string | No | Exact niche name; valid values listed on the niches field of search\_inserts. Omitting it is valid – prices under the no-niche rate | Errors: unknown niche name → explicit error. Scope: filed under the caller's default workspace. ### Tool annotations (readOnlyHint / destructiveHint/ openWorldHint/ idempotentHint) | Tool | readOnlyHint | destructiveHint | openWorldHint | idempotentHint | | ------------------------------ | ------------ | --------------- | ------------- | -------------- | | list\_categories | true | — | false | — | | search\_guest\_posts | true | — | true | — | | search\_inserts | true | — | true | — | | search\_backlinks | true | — | true | — | | domain\_lookup | true | — | true | — | | search\_backlinks\_gap | true | — | true | — | | referring\_backlinks | true | — | true | — | | search\_insert\_pages | true | — | true | — | | get\_cart | true | — | false | — | | add\_guest\_post\_to\_cart | — | true | false | false | | add\_link\_insertion\_to\_cart | — | true | false | false | ### Troubleshooting Insert.Link doesn't show up in Claude's connector directory – Make sure Claude is fully updated. On desktop, quit and reopen the app; on the web, refresh the page. If it still doesn't appear, search the directory for "Insert.Link" directly. Connection fails or no tools appear – Confirm you're signed in to the correct Insert.Link account, and that the account has an active workspace. Contact support if the issue persists. Authentication errors – Follow the login prompts in your AI client. In Claude, you can disconnect and reconnect Insert.Link from Settings → Connectors to restart the OAuth flow. In other clients, remove and re-add the connector. A tool call fails with an unknown host / niche / domain error – Most search and cart tools expect exact values copied from a prior search result (site host, page URL, niche name), not values typed from memory. Re-run the relevant search tool and use its output directly. Stale results or slow responses – The MCP server queries live marketplace data. If responses are slow, try narrowing your filters or reducing the requested page size. Tool not found / connection URL rejected – Double-check the MCP Server URL was copied exactly, with no extra spaces. Restart your AI client after changing connector settings. ### Privacy Policy Your privacy: see our [Privacy Policy](https://insert.link/privacy-policy/) for how account and usage data is handled. ### Security Reporting a vulnerability: email . Domain and API ownership: api.insert.link and insert.link are both owned and operated by Insert.Link. ### FAQ
Which AI assistants are supported? Insert.Link works with ChatGPT, Claude, Grok and other MCP-compatible clients. If your preferred AI client supports the Model Context Protocol (MCP), you can connect it using the Insert.Link MCP Server URL. All you need is an active Insert.Link account — including a trial account: the tools return whatever catalog and pricing that account has access to, so you can connect and try the integration before committing to a paid plan.
What can my AI assistant do after connecting? Once connected, your AI assistant can interact with the Insert.Link marketplace through MCP tools. Available capabilities include: * Search guest post opportunities * Search link insertion opportunities using natural language * Discover backlink gap opportunities * Find referring domains * Search by anchor text * Look up domain metrics and referring backlinks The exact experience depends on the AI client you're using, but all supported clients access the same Insert.Link marketplace and data.
What are some example prompts I can try? Once connected, here are a few things you can ask your AI assistant: * Find tech blogs in the US under $300 with DR above 40 * Look up the backlink profile for competitor.com * Run a backlink gap between mysite.com and competitor1.com, competitor2.com * Find sites already linking with the anchor 'best seo tools' * Show me what's in my cart and the total * Search this site for pages about AI tools with 1k+ traffic, then add the best one to my cart * Which sites link to both competitor1.com and competitor2.com? * Add this site to my cart as a guest post in the Crypto niche * What content categories can I filter guest posts by? * Find health-niche guest post opportunities in Germany with traffic over 1k * Show me sites that link to my competitors but don't link to me yet
Is my account secure? Yes. Insert.Link uses OAuth authentication, so your AI assistant never receives your password or account credentials. You remain in control of every connection and can revoke access at any time from the Active Sessions section.
Can I connect multiple AI assistants? Yes. You can authorize multiple AI assistants simultaneously (for example, ChatGPT, Claude). Each connection appears separately in Active Sessions and can be revoked independently.
How do I revoke access? Open the Active Sessions section on this page and click Revoke access next to the AI assistant you want to disconnect. Access is revoked immediately and can be restored later by authorizing the client again. Why are some search results different between AI assistants? All supported AI assistants use the same Insert.Link MCP server and access the same marketplace data. However, different AI models may interpret your request differently, choose different search strategies, or present the results in their own way.
Does connecting through MCP change my Insert.Link account? No. Connecting through MCP does not modify your account, projects, or existing data automatically. Your AI assistant only performs actions that you explicitly request using the tools available through the Insert.Link MCP server.
Can my AI assistant place orders automatically? No. Your AI assistant can search the Insert.Link marketplace and add selected opportunities to your shopping cart. Before any order is submitted, you review the selected websites, verify the details, and confirm the purchase yourself. This ensures that every order is reviewed and approved by you before it is submitted.
How to connect to Claude? From the Connectors Directory (recommended) 1\. Open Settings 2\. Select Connectors 3\. Find Insert.Link in the directory (or search for it) 4\. Click Connect 5\. Click Sign in with Insert.Link 6\. Click Authorize As a custom connector Watch this video to see how to add the MCP server: [Watch the video](https://youtu.be/AN4fzGsD7yI) 1\. Open Settings 2\. Select Connectors 3\. Click Add 4\. Select Add custom connector 5\. Fill in the fields in the popup: \- Name – name your tool (e.g. "Insert.Link") \- Remote MCP server URL – paste \- Leave Advanced settings as default 6\. Click Create 7\. Click Connect 8\. Click Sign in with Insert.Link 9\. Click Authorize
How to connect to ChatGPT? Watch this video to see how to add the MCP server: [Watch the video](https://youtu.be/D5FsNnpScqQ) * Open Settings * Select Apps * Select Advanced settings * Enable Developer mode * A Create app button will appear – click it * Fill in the fields in the popup: * Name – name your tool (e.g. "Insert.Link") * Description – optional * Connection – paste the MCP server URL * Authentication – select OAuth * Check "I understand and want to continue" * Click Create * Click Sign in with Insert.Link * Click Authorize
How to connect to Grok? Watch this video to see how to add the MCP server: [Watch the video](https://youtu.be/tPEMe8Xlwx8) * Open Settings * Select Connectors * Click Add * Select Add custom connector * Fill in the fields: * Name – name your tool (e.g. "Insert.Link") * Server URL - paste the MCP Server URL * Leave the default authentication settings * Click Connect * Click Sign in with Insert.Link * Click Authorize

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.insert.link/mcp-server-technical-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.