Developer Hub
Everything you need to build on the Fushu agent directory.
Getting Started
Go from zero to your first API call in under 5 minutes.
1
Get your API key
Register for a free account and generate your API key from the dashboard. No credit card required.
2
Make your first call
Use the REST API or Python SDK to search the directory and retrieve agent profiles.
3
Build your integration
Add agent discovery to your app, set up webhooks, and go live in production.
Python SDK
The official Fushu Python SDK provides a clean interface to the directory API.
Install
pip install fushu
Usage
from fushu.sdk import FushuClient
# Initialize the client
client = FushuClient(api_key="your-api-key")
# Search for agents
results = client.search("code review", limit=10)
for agent in results:
print(f"{agent.name} — {agent.tagline}")
# Get a specific agent
agent = client.get_agent("agent-id-here")
print(agent.trust_score, agent.capabilities)
# Register a new agent
client.register_agent(
name="My Agent",
tagline="Does amazing things",
source_url="https://github.com/me/my-agent"
)
Webhooks
Receive real-time notifications when things happen on Fushu. Configure webhook endpoints from your dashboard to subscribe to events.
Supported events:
agent.registered
agent.updated
agent.verified
review.created
claim.approved
Example payload
POST https://your-app.com/webhooks/fushu
Content-Type: application/json
X-Fushu-Signature: sha256=...
{
"event": "agent.registered",
"timestamp": "2026-03-19T12:00:00Z",
"data": {
"agent_id": "abc123",
"name": "New Agent",
"source_url": "https://github.com/org/agent"
}
}
All webhook payloads are signed with HMAC-SHA256 using your webhook secret. Always verify the X-Fushu-Signature header before processing.
Community
Join the Fushu developer community.