Skip to main content
Connect CivicMarketplace to Claude and ask about contracts and suppliers directly in your conversations.
Custom connectors are available on Claude Pro, Max, Team, and Enterprise plans. On Team and Enterprise, an administrator may need to enable connectors for the organization first.
The endpoint you’ll use:

​
Claude.ai (web)

1

Open connector settings

Go to Settings → Connectors and click Add custom connector.
2

Enter the connector details

  • Name: CivicMarketplace
  • URL: https://mcp.civicmarketplace.com/mcp
Click Add.
3

Sign in to CivicMarketplace

Click Connect. A CivicMarketplace sign-in window opens — log in with your normal account and approve the requested permissions.
4

Start asking

In a new chat, open the tools/connectors menu and confirm CivicMarketplace is enabled. Then ask something like “Search CivicMarketplace for janitorial contracts.”

​
Claude Desktop

1

Open Connectors

Open Settings → Connectors. You’ll see your existing connectors grouped under Web and Desktop.
2

Add a custom connector

Click the + button at the top of the Connectors panel, then choose Add custom connector from the menu.
3

Enter the connector details

  • Name: Civic Marketplace
  • URL: https://mcp.civicmarketplace.com/mcp
Click Add.
4

Sign in to CivicMarketplace

Click Connect. A CivicMarketplace sign-in window opens — log in with your normal account and approve the requested permissions. The connector will then appear under Web and show a Disconnect button once it’s linked.
5

(Optional) Set tool permissions

Open the connector to see its Tool permissions. CivicMarketplace tools include read tools and scoped write tools; each can be set to Allow, Needs approval (the default), or Disallow. Leaving them on Needs approval means Claude asks before each use.

​
Claude Code (CLI)

1

Add the connector

This only registers the server — it does not sign you in yet. claude mcp list will show it as ! Needs authentication, which is expected at this point.
2

Authenticate from inside Claude Code

Authentication doesn’t happen from claude mcp add or claude mcp list — it happens inside an interactive session. Start Claude Code:
Then run the /mcp command, select civicmarketplace, and choose Authenticate. Your browser opens the CivicMarketplace sign-in page — log in and approve the requested permissions, then return to the terminal.
3

Confirm it's connected

Still in the session, run /mcp again — civicmarketplace should now show as connected. From a fresh terminal you can also check:
It should now read civicmarketplace: … - ✓ Connected.
claude mcp list only reports status — it never opens the login window. If a server shows ! Needs authentication, run /mcp inside claude to sign in.

​
Troubleshooting

Make sure pop-ups are allowed for Claude, and that you’re signing in with the same email you use for CivicMarketplace. If you recently changed your access, disconnect and reconnect the connector to refresh your session.
Confirm the connector is toggled on for the current chat (in the tools/connectors menu), then try again. Custom connectors must be enabled per conversation in some clients.
The connector only returns data your CivicMarketplace account can access. If you expect to see something you can’t, contact your account manager — your account may need additional access in CivicMarketplace itself.

​
Next steps

Example prompts

See what you can ask once you’re connected.

Tools and permissions

Review the MCP tools and required permissions.