Skip to main content

​
Zero to First Tool Call

The fastest path: sign up, get a token, make a call.
1

Sign up

Go to app.civic.com and create a free account. You get 10,000 credits and 14 days.
2

Complete onboarding

Select your AI framework and tools. On the Install step, you’ll see your MCP URL.
3

Generate a token

On the Install screen, choose Generate a Civic token (best for automation) and copy it.
4

Make your first call

Pass the token as a Bearer header and the MCP URL to your agent or client:
curl -X POST https://app.civic.com/hub/mcp \
  -H "Authorization: Bearer $CIVIC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'
You should see the list of tools available in your configured toolkit.

​
Choose Your Path

​
Path 1 — Civic Chat (Zero Setup)

The fastest way to start. No client configuration, no credentials file. Sign up at app.civic.com and you’re in your control plane. Use Civic Chat to:
  • Configure toolkits and guardrails in plain English
  • Query your agent’s audit log
  • Revoke access instantly at any granularity

Open Civic Chat

Sign up free — 10,000 credits, 14 days trial

What is Civic Chat?

Learn about the Configurator, Audit, and Revocation agents

​
Path 2 — Integrate Your Agent or Client

Connect your existing AI agent or client via HTTP. Before you connect: Get your credentials — your MCP URL and (for agents) a Civic token.

Get Your Credentials

MCP URL, toolkit URL params, and how to generate a token
Pick your integration:

LangChain / LangGraph

Python agents • streamable_http

Vercel AI SDK

TypeScript / Next.js

Anthropic SDK

Direct Anthropic SDK

OpenAI Agents SDK

OpenAI Agent Builder

OpenAI SDK

Standard OpenAI SDK

Python / Pydantic AI

Pydantic AI agents

Python MCP Client

Direct Python MCP client + adapters
Clients (interactive):

Claude Desktop

2 mins

Claude.ai

2 mins

Cursor

3 mins

VS Code

3 mins

Windsurf

Native HTTP • 5 mins

JetBrains IDEs

Via mcp-remote • 5 mins

Goose

Block’s agent • 5 mins

Gemini CLI

Google Gemini • 3 mins

Codex

OpenAI Codex • 3 mins

ChatGPT

Status and roadmap

Mistral LeChat

Direct connector • 2 mins

​
Path 3 — Deploy an Agent

If you’re building a production agent deployment, see the agent deployment guide. It covers profile locking, URL parameters, and authentication for agents that run unattended.

Agent Deployment

Profile locking, toolkit URL params, skills pre-loading, and agent authentication

​
Your MCP URL

All agents and clients connect to: 
https://app.civic.com/hub/mcp
Add URL parameters to lock your agent to a specific toolkit: 
https://app.civic.com/hub/mcp?profile=your-toolkit

Credentials and URL Parameters

Full reference for MCP URL, toolkit params, tokens, and OAuth vs token auth

​
Need Help?

Client Compatibility

Full matrix of supported clients and connection methods

Troubleshooting

Common setup issues and solutions