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 About 2 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.