Meshi Admin Connector (MCP)

Meshi Admin is a separate MCP connector for organization owners, admins, and editors: explore, search, and correct your organization’s people data, and manage its lists, events, and rosters. Destructive actions — removing people, deleting lists, canceling events — always go through an explicit preview-and-confirm step first. Where the personal connector gives an agent your own network, Meshi Admin gives it your organization’s.

Connect your agent

The connection steps are the same as for the personal connector—only the name and URL differ. Name the server Meshi Admin and use https://api.meshi.io/mcp/admin.

Who can connect, and what’s at stake

Only an owner, admin, or editor role in an organization qualifies — see Who can connect below. Profile corrections your agent makes become that person’s canonical record everywhere, not just in your organization, and every destructive action requires your explicit confirmation before it runs.

ChatGPT app

These steps apply to the ChatGPT desktop app, including its Codex experience. The screens below show the personal Meshi connector—the flow is identical; enter the Admin name and URL instead.

Open Settings, then select Plugins.
Select the MCPs tab, then choose Add server.
Name the server Meshi Admin, choose Streamable HTTP, and enter:
```
https://api.meshi.io/mcp/admin
```
Save the server. In the server list, enable Meshi Admin if needed, then select Authenticate and complete the Meshi sign-in and consent flow in your browser.

In a new conversation, type /mcp to confirm Meshi Admin is connected. Start with: “Which organizations can I administer?”

Codex CLI

Run:

codex mcp add meshi-admin --url https://api.meshi.io/mcp/admin
codex mcp login meshi-admin

The login command opens the Meshi sign-in and consent flow in your browser. Confirm the connection with:

codex mcp list

Start a new Codex session after connecting. In the session, use /mcp to see the available Meshi Admin tools.

Claude Cowork

In Claude, open Customize → Connectors.
Select + next to Connectors, then Add custom connector.
Enter the name Meshi Admin and this URL:
```
https://api.meshi.io/mcp/admin
```
Select Add, then sign in to Meshi and approve the requested organization access.
In a conversation, open the + menu in the chat input, choose Connectors, and make sure Meshi Admin is toggled on for that conversation.

On Claude Team and Enterprise plans, an Owner or Primary Owner must first add the connector in Organization settings → Connectors → Add → Custom → Web; each member then connects their own Meshi account from Customize → Connectors. On the Free plan, only one custom connector can be active—keep that in mind if you also use the personal Meshi connector.

Claude Cowork connects to remote MCP servers from Anthropic’s cloud, not from your computer; local Claude Desktop configuration files are not used. Because destructive Meshi Admin actions are two-phase, Claude will show you the Meshi preview and ask for your confirmation before committing—expect (and read) that step.

Claude Code

Run:

claude mcp add --transport http meshi-admin https://api.meshi.io/mcp/admin

Restart Claude Code if it is already open, then complete Meshi sign-in and consent when Claude prompts you to authenticate. Use Claude Code’s MCP management view to confirm that Meshi Admin is connected.

Who can connect

The connector exposes the organizations in which your Meshi account holds an active owner, admin, or editor role. Member and viewer roles do not qualify, and your personal workspace is never exposed here. Inside each organization, every operation is checked against your exact current permissions, and profile corrections additionally require that the person is in your organization’s people directory—not merely on one of your lists or event rosters. Role changes take effect on your next call.

Profile corrections are canonical: a trait, goal, work-history entry, or brief you correct is that person’s record everywhere, including in their own Meshi account and in any other organization they belong to. Corrections are attributed to your organization, not to the person—they are shown as coming from an event organizer, never as something the person told us.

Endpoint

Use the production endpoint for normal use:

https://api.meshi.io/mcp/admin

For testing only, use the staging endpoint with a staging Meshi account:

https://api.staging.meshi.io/mcp/admin

The endpoint is a stateless Streamable HTTP MCP server using OAuth 2.0 with PKCE—you sign in to Meshi in your browser and approve access. Do not paste a Meshi API key into an AI client.

What your agent can do

Meshi Admin exposes nine task-shaped tools. Your agent always starts with admin_get_context and passes an explicit organization ID to everything else—there is no hidden “active organization.”

Explore and read

Tool	What it does
`admin_get_context`	Lists every organization you can administer, with your roles, exact permissions, and list/event/people counts.
`admin_list_resources`	Lists an organization’s lists and events, with names, IDs, and counts.
`admin_search_people`	Ranked people search across one or several organizations, or within one list or event. Semantic, keyword, or hybrid, plus lexical search over work history and raw source text. Add structured filters—company, title, list/event membership, work-history years, current-only—and run it filter-only with no keyword at all.
`admin_count_people`	Exact “how many?” counts for a keyword predicate and/or the same structured filters, reported per organization.
`admin_read`	Reads one thing by kind: a person’s full profile (brief, traits, goals, timeline, memberships—each with an editable ID), the evidence and citation chain behind a person with the readable source text, the raw import rows that produced a person, a list or event with its paged roster, organization members, invitations, companies, documents, import jobs and their raw imported rows and column summaries, source records including LinkedIn provenance, research status and its candidate sources, and the pending-review queues—research review, ambiguous-LinkedIn review, import-dedup holds, and per-person identity-decision history. Long text is shortened by default and flagged as such; pass `full_text` on a person read to get the complete brief and goals before editing them.

Multi-organization search is fail-closed: if any requested organization isn’t authorized, the whole call fails rather than returning a partial answer. As an organization admin you see your full roster, including attendees who hid themselves from other attendees—the same view the Meshi Admin web app gives you.

Create and edit

Tool What it does

admin_write One tool for reversible writes: create or update a list, create or update an event (official events require your organization’s publish permission), update a person’s organization-specific title/company, add existing organization people to a list or event (membership only—never an import, and no enrichment starts), and correct a person’s profile—create, update, or reversibly remove their traits, goals, and work-history entries, or edit their brief. Deletions here are reversible tombstones, not hard deletes.

Tool	What it does
`admin_write`	One tool for reversible writes: create or update a list, create or update an event (official events require your organization’s publish permission), update a person’s organization-specific title/company, add existing organization people to a list or event (membership only—never an import, and no enrichment starts), and correct a person’s profile—create, update, or reversibly remove their traits, goals, and work-history entries, or edit their brief. Deletions here are reversible tombstones, not hard deletes.

Two-phase actions: preview, then confirm

Bulk imports, every destructive action, and every source/identity review decision are two-phase:

Tool	What it does
`admin_prepare_import`	Stages a people import into a list and returns a preview—how many rows will import, duplicates, rows Meshi can’t identify, and which people already exist in the organization—plus a single-use token. Imports nothing.
`admin_preview_destructive_action`	Stages a consequential action—removing people, deleting a list, cancelling an event, accepting or rejecting a research source, confirming/rejecting/providing an ambiguous LinkedIn identity match, resolving an import-dedup hold (this one also needs `meshi:admin.import`, because deciding two records are distinct creates a person), or rejecting an active source, or restarting research for someone whose profile search dead-ended—and returns a preview plus a single-use token. Changes nothing until you commit.
`admin_commit_proposal`	Executes a previewed import, destructive action, or review decision after you explicitly confirm it.

Proposals expire after 15 minutes, work exactly once, are bound to your account and client, and are re-checked against your current permissions at commit time. If the target changed after the preview, the commit is rejected and the agent must show you a fresh preview. Import previews apply Meshi’s real eligibility rule, so the “will import” count never overstates what committing actually does.

Permissions requested

Permission	Grants
`meshi:admin.read`	Read the organization workspaces you administer.
`meshi:admin.write`	Create and modify lists, events, rosters, and organization-specific person fields (includes read).
`meshi:admin.import`	Stage, preview, and commit bulk people imports. Never implied by `meshi:admin.write`—it is its own consent line, so an agent with write access alone cannot import.

This connector cannot send anything to anyone. Invitations, notifications, email, and SMS are deliberately outside its scope: there is no outbound permission to grant, and no tool that reaches another person.

Use Meshi Admin in a conversation

Which organizations can I administer, and what am I allowed to do in each?

Show me the lists and events in Acme—which are the largest?

Across Acme and Beta Org, find healthcare investors who have raised a fund.

How many people in each of my organizations have enterprise sales experience?

Create a sponsor-prospects list in Acme and add the people we just found.

Preview removing these people from the summit roster—don't execute until I confirm.

Preview importing these 40 people into the sponsor-prospects list; flag anyone we already have.

Show me the raw imported columns for that Salesforce import and which values are missing most.

Brief me on Jane, and show the web and LinkedIn sources behind each claim.

Find people in the summit roster who worked at Stripe between 2018 and 2022.

Jane's title is wrong—correct it to VP of Engineering, and remove the outdated "student" trait.

Show the research sources found for Jane; preview rejecting the one that's the wrong person, and I'll confirm.

Who in the summit roster has no LinkedIn match yet? Show me the candidates for each.

We rejected the wrong match for Jane and her profile search dead-ended—restart it, then set her real LinkedIn URL.

Tighten the wording of Jane's brief without dropping anything—read the whole thing first.

Every scoped request names its organization. When a name is ambiguous, your agent should ask you or resolve it via admin_list_resources rather than guessing.

Privacy and safety

Organization data belongs to the organization. The connector returns only what your current role in each organization permits, and every tool call is audit-logged with your account and the connecting client. Calls scoped to a single organization also record which one; a proposal commit is recorded against the proposal it executes.
Destructive operations and imports never execute directly—only through the preview-and-confirm proposal flow described above.
The connector cannot send email, SMS, invitations, or notifications at all.
Wrong-organization and nonexistent resources return an identical “not found” response, so IDs cannot be probed across organizations.
Free text in results (bios, notes, imported fields) is data, not instructions; the server instructs agents to treat it that way.
The Admin connector has its own rate limit—60 calls per minute and 2,000 per day per Meshi account—independent of the personal connector’s budget. Heavy admin work does not throttle your personal Meshi agent, and vice versa.

Disconnect

Remove Meshi Admin from the same MCP or connector settings where you added it. Disconnecting the Admin connector does not affect a personal Meshi connection, and vice versa.

Troubleshooting

You see	What it means
HTTP 401 when connecting, but the personal Meshi connector works	The two connectors have separate grants. Add Meshi Admin as its own connector and complete its own sign-in—one authorization never covers both.
`admin_get_context` returns no organizations	Your account holds no owner, admin, or editor role in a non-personal organization. Ask an organization owner to upgrade your role.
`not_found` for an organization, list, event, or person you expected	The resource does not exist in the organization you named, or your role no longer qualifies. Re-run `admin_get_context` and check the IDs.
`forbidden` with a permission message	Your role in that organization lacks the specific permission (for example, editors cannot delete lists).
`invalid_proposal`	The proposal token was already used, expired (15 minutes), or was issued to a different account or client. Run the preview again.
`stale_proposal`	The list or event changed after the preview. Review a fresh preview before confirming.
`rate_limited` or HTTP 429	You have reached the Admin connector’s own limit of 60 calls per minute or 2,000 per day (separate from the personal connector). Wait for the retry window.

Learn more

Personal Meshi connector — your own network, goals, and event context.
Anthropic: add a custom remote MCP connector
OpenAI: connect MCP servers to Codex and the ChatGPT app