Skip to main content
Deva Agent Key (API)

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:

  1. What agent are you using? — Select from:

    • Claude Code

    • Cursor

    • Claude.ai

    • OpenAI / custom agent

    • REST client

  2. Setup instructions — Tailored to your selection (see Step 4 below).

  3. 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):

  1. Click Create API Key.

  2. Your key is displayed once — copy it immediately and store it securely.

  3. 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/mcp

  • REST 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:

PlanPriceMonthly Credits

Free

$0

Limited

Plus

$20/mo

22,000

Super

$100/mo

110,000

Ultra

$200/mo

220,000

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.