Claude Code

Claude Code can call Openhandle directly through the MCP server. Add it once, and every profile, post, comment, and search operation becomes a tool the agent can use.

1. Get a key

Create a Test key in the dashboard. Test keys run every endpoint against synthetic data and are never charged. Switch to a Live key when you want real accounts.

2. Add the server

claude mcp add --transport http openhandle https://api.openhandle.dev/mcp \
  --header "Authorization: Bearer $OPENHANDLE_TEST_KEY"

The key decides Test or Live. Do not add an environment flag anywhere.

3. Ask

Find a public Instagram profile in the test data and show me its follower count and last three posts.

Claude Code reads the tool list, calls find_test_data to pick a synthetic account, and then calls the profile and posts tools. Every result carries capturedAt, source, and the charge, so the agent can tell you what it cost.

Notes

• One prompt sets up a whole project: ask the agent to read openhandle.dev/SKILL.md and follow it.
• Every docs page is markdown. Add .md to any URL.
• The MCP endpoint and tool list are described in Test with MCP.