Quickstart: register an agent and make your first call
Get from zero to your first API call in under 5 minutes.
Written By Deva
Last updated 3 months ago
Step 1: Create Your Account
Go to agentkey.deva.me and sign in with Deva SSO:
Google, GitHub, Apple, Telegram, passkey, or magic link
No new password to create
Step 2: Onboarding
After signing in, the onboarding flow asks:
What agent are you using? — Select from:
Claude Code
Cursor
Claude.ai
OpenAI / custom agent
REST client
Setup instructions — Tailored to your selection (see Step 4 below).
Example prompts — Try these with your agent to verify everything works.
Step 3: Generate Your API Key
During onboarding (or anytime from the Keys page):
Click Create API Key.
Your key is displayed once — copy it immediately and store it securely.
The key format is
deva_*(e.g.,deva_abc123def456...).
You can create up to 10 active keys. Keys can be rotated or revoked at any time.
You also get a $1 free signup credit to start testing immediately.
Step 4: Connect Your Agent
Claude Code
Add Deva as an MCP server:
claude mcp add deva \ --transport http \ https://api.deva.me/mcp \ --header "Authorization: Bearer deva_YOUR_KEY_HERE" That's it. Claude Code will now discover all 50+ APIs as available tools. Try asking:
"Search Google for the latest Next.js documentation"
"Get the current weather in San Francisco"
Cursor
Add to your Cursor MCP configuration (.cursor/mcp.json):
{ "mcpServers": { "deva": { "url": "https://api.deva.me/mcp", "headers": { "Authorization": "Bearer deva_YOUR_KEY_HERE" } } } } Restart Cursor, and the Deva tools will be available.
REST API (Any Agent or Script)
Make HTTP calls directly:
curl -X POST https://api.deva.me/v1/run/google_search \ -H "Authorization: Bearer deva_YOUR_KEY_HERE" \ -H "Content-Type: application/json" \ -d '{"query": "latest AI research papers"}' Other Agents
Any agent or tool that supports MCP or HTTP can integrate with Deva:
MCP URL:
https://api.deva.me/mcpREST base URL:
https://api.deva.me/v1/run/Auth:
Authorization: Bearer deva_YOUR_KEY_HERE
Step 5: Choose a Plan
After testing with your free credit, pick a subscription:
Upgrade anytime from agentkey.deva.me/app/billing.
Verify It's Working
Check Your Balance
Your credit balance is shown in the header at agentkey.deva.me/app. After making a call, you should see a small deduction.
Check Key Usage
Go to the Keys page. Each key shows its last_used_at timestamp — if it's recent, your integration is working.
Check Transaction History
Go to Billing to see individual API call debits with resource names and costs.
Troubleshooting
"Unauthorized" or 401 error → Double-check your API key. Make sure the Authorization header format is Bearer deva_YOUR_KEY (with the space after "Bearer").
"Insufficient credits" or 402 error → Your balance is empty. Purchase credits at agentkey.deva.me/app/billing.
MCP tools not showing up in Claude Code → Restart Claude Code after adding the MCP server. Run claude mcp list to verify the server is registered.
Key not working after rotation → After rotating a key, the old key is immediately revoked. Update your agent's configuration with the new key.
Was this helpful?
More in Deva Agent Key (API)
Credits, karma, and paymentsSDK and MCP serverStill need help? Share an idea