Software

What gets a Claude connector rejected from the directory

By · Sat Aug 22 2026 · 6 min read · 0 views

View as a Web Story

Software#anthropic#mcp#claude#connectors#directory#review

Claude Connectors Directory submission review and its rejection triggers

Most guides to the Claude Connectors Directory explain how to submit. This one covers what fails. The triggers are published, exact, and easy to hit by accident. The most common one is a design choice many MCP servers ship on day one.

If your server exposes a single api_request tool with a method parameter, it will be rejected. Splitting it is not optional, and no amount of description text saves it.

You may not be able to submit at all

The portal lives in Claude.ai org settings. So your plan decides access before any code does. The Connectors Directory is Anthropic's reviewed listing of MCP servers that users can add in one click. The directory submission docs set out who may submit and what the portal collects.

You need a Team or Enterprise org. By default only Owners and Primary Owners can submit or manage a listing. On Enterprise, an Owner can hand that to a custom role. The role needs the Directory permission, or the wider Libraries one. Team plans have no custom roles, so it stays with Owners.

Desktop extensions are a separate path. An MCP Bundle (MCPB) is a local MCP server packaged for Claude Desktop, and it uses its own desktop extension submission form rather than the portal.

The tool design rules that fail review

Four rules in Anthropic's pre-submission checklist cause most tool-level rejects. Each is mechanical. You can check all four before a reviewer does.

  1. Split read from write. A tool that accepts GET, HEAD and OPTIONS alongside POST, PUT, PATCH or DELETE is rejected. Split writes further by action where you can: create, update, delete.
  2. Name the API in freeform query tools. If a tool takes endpoint paths or request bodies the caller builds, its description must name or link the target API. For example, "Queries the Slack Web API" with a link passes, while "Makes a request to the API" fails.
  3. Add hints to every tool. Each tool needs a title plus readOnlyHint: true or destructiveHint: true.
  4. Keep tool names to 64 characters or fewer.

Servers often expose more than their authors meant to, as the release where MCP Adapter 0.6.0 exposes abilities you did not pick showed. That third rule is worth more than a checkbox. The hints drive auto-permissions in Claude. Read-only tools can run with no prompt each time. Write tools always ask first. Skip the hints and your connector is both non-compliant and slower to use.

Prompt injection language gets you rejected too

A tool description is read as an instruction, not as marketing. The rules sit on the same review criteria page. Anthropic rejects text that tells Claude to call software the user did not ask for. It also rejects text that blocks Claude from calling other tools, or that pulls behavior from an outside source.

Hidden or encoded text fails. So does text that tries to override system rules or push a product. The rule is short. Say what the tool does. Do not tell Claude how to act. It is the same class of risk as an AI agent that can infect the next one through AGENTS.md: instructions arrive as data and get followed.

Two more rules sit next to it. Do not take chat data beyond what the tool needs. Do not read Claude's memory, chat history, summaries or user files.

Advertisement

Two categories that are simply not accepted

Some connectors fail on subject, not on quality. Anthropic does not accept ones that move money, crypto or other assets. It does not accept ones that make images, video or audio with AI models.

One carve-out is worth knowing. Design tools that draw diagrams, charts or UI mockups are fine. The line falls at generated media, not at visual output as such.

Your server must call your own APIs, or ones you proxy with permission. The MCP server domain should match your service. Plugins face a harder rule. They must link a public GitHub repo, and closed source is out.

The asset specs people get wrong

An MCP App is an MCP server that draws its own UI inside Claude. If you submit one, the listing needs carousel screenshots. The specs are exact, and the rows below are where entries bounce.

Asset or field Requirement
Screenshots PNG, at least 1000px wide, 3 to 5 images
Screenshot crop The app response only, with the prompt excluded
Video or GIF Not accepted
Server name 100 characters maximum
Tagline 55 characters maximum
Description 2,000 characters maximum
Categories One to five
URL slug Permanent once published

Aspect ratio is free. No mobile assets are needed. You send the prompt text for each shot as a separate field. Anthropic ships a carousel template in the MCP Apps Figma community file.

What the portal asks for, step by step

The portal runs to eleven steps. Your progress saves in the browser as you move. Have four things ready first: a docs URL, a privacy policy URL, an icon, and test account logins.

The steps run in this order: intro, connection, tools, listing, use cases, company, sign-in, data handling, test and launch, compliance, review. The tools step syncs from your live server. It sorts tools by whether the hints mark them read-only or write. Tools with no hints land in their own group. That is how a missing hint is caught before a human sees it.

Two steps trip people up. Test and launch needs steps good enough for a reviewer to drive your server end to end. That includes a login for a full, populated account. Compliance asks you to tick seven boxes. They cover directory rules, first-party API use, money transfers, AI media, prompt injection, chat data, and public docs. All seven are required.

Community listing now, verified later

Getting in is not the same as being vetted. Anthropic sets out the two labels in its connector verification docs. A new server is scanned by machine for policy issues. By default it lands as a community connector.

Anthropic may then move a listing it rates as useful into verified review. That path is slower and more hands-on. Each tool is reviewed by a person, not by a scanner. The move is picked by machine, so there is nothing to apply for. The label is a signal to users. It does not change how the connector runs.

Both labels face the same bar. A tool must return a real answer for valid inputs. A generic error, such as "Internal Server Error", fails. Answers should fit the task, not dump a whole table. Public documentation is required by your publish date, and a blog post or help-center article is enough. All listings must also comply with the Anthropic Software Directory Policy.

Should you submit at all?

Submit if you have three things: a Team or Enterprise org, your own API, and tools split by action. The listing is real reach. The work it asks for is work a good connector needs anyway.

Wait if any of three things is true. Your tools have no hints. Your server proxies an API you do not control. Or your only account is an individual plan. Fix those, then submit. Before you do, exercise every tool through the MCP Inspector and as a custom connector, and email mcp-review@anthropic.com if you need to escalate a stuck review. If a tool fails to connect during your own testing, our guide to when Claude cannot reach your MCP server covers the usual causes.

Advertisement

FAQ

Who can submit a connector to the Claude Connectors Directory?

Only members of a Team or Enterprise organization. The submission portal sits in Claude.ai organization settings, and by default only Owners and Primary Owners have access. Enterprise Owners can delegate through a custom role with the Directory or Libraries permission.

Why was my MCP server rejected from the Connectors Directory?

The most common causes are a catch-all tool that mixes read and write methods, tools missing a `title` and a `readOnlyHint` or `destructiveHint` annotation, a missing privacy policy, generic error responses, or descriptions that instruct Claude rather than describe the tool.

Do Claude connector tools need annotations?

Yes. Every tool must include a `title` and the applicable hint. Read-only tools use `readOnlyHint: true` and can run without a per-call confirmation. Tools that modify or delete data use `destructiveHint: true` and always prompt the user.

How long does Claude connector review take?

Anthropic does not publish a fixed turnaround. Review times vary with queue volume, and the portal stays open. Track status and reviewer feedback in the submissions dashboard, and use the review contact address for escalations.

What is the difference between a community and a verified connector?

Community is the default listing after an automatic policy scan. Verified is a higher-touch review that Anthropic escalates to on its own assessment, where reviewers functionally test every tool. Both must meet the same criteria, and the label does not change how the connector behaves.

Comments

Loading…

Sign in to join the conversation.

Related posts

How MCP tool definitions and tool output consume Claude's context window

Your MCP connector spends context before you type

The advice you have read about MCP context cost is out of date. The old rule was simple. Every tool you connect gets injected up front, so a big connector spends a chunk of the window before you type

Sat Aug 22 2026 · 6 min read · 0 views

AISoftware