How do I use oaid-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@oaid-mcp Check the credit score for did:oaid:0x123abc456def" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

oaid-mcp

MCP (Model Context Protocol) server that lets AI agents securely use their Open Agent ID credential. The agent can sign requests, look up other agents, check credit scores, and exchange messages -- all without ever seeing the private key.

Install

pip install oaid-mcp

Configure

Set the path to your agent credential file:

export OAID_CREDENTIAL_FILE=/path/to/agent-credential.json

The credential file is generated by the agent-id CLI or SDK when you register an agent on-chain.

Use with Claude Code

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "oaid": {
      "command": "oaid-mcp",
      "env": {
        "OAID_CREDENTIAL_FILE": "/path/to/agent-credential.json"
      }
    }
  }
}

Security

The private key is loaded by the MCP server process and never exposed to the AI agent. All cryptographic operations (signing, encryption) happen inside the server. The agent only receives DIDs, public info, and operation results.

Available tools

Tool	Description
`oaid_whoami`	Returns the agent's DID and public info (no private key)
`oaid_sign_request`	Signs an HTTP request and returns authentication headers
`oaid_check_credit`	Checks any agent's credit score via the registry
`oaid_lookup_agent`	Looks up agent info by DID
`oaid_send_message`	Sends a signed message to another agent
`oaid_get_messages`	Gets messages addressed to this agent
`oaid_send_encrypted_message`	Sends an end-to-end encrypted message to another agent