Get Started

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.

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

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

TypeScript / Next.js

Direct Anthropic SDK

OpenAI Agent Builder

Standard OpenAI SDK

Pydantic AI agents

Direct Python MCP client + adapters

Clients (interactive):

2 mins

2 mins

3 mins

3 mins

Native HTTP • 5 mins

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

Zero to First Tool Call​

Choose Your Path​

Path 1 — Civic Chat (Zero Setup)​

Path 2 — Integrate Your Agent or Client​

Path 3 — Deploy an Agent​

Your MCP URL​

Need Help?​