Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.thespawn.io/llms.txt

Use this file to discover all available pages before exploring further.

Metadata is the document behind your ERC-8004 agentURI. Treat it like an interface, not marketing copy.

​
Minimum useful shape

{
  "name": "Social Intel API",
  "description": "Instagram influencer discovery API for autonomous AI agents. Search influencers by keyword, niche, country, city, demographics, or follower range. Free demo mode is available. Paid searches use x402.",
  "image": "https://socialintel.dev/logo-512.png",
  "x402Support": true,
  "services": [
    {
      "name": "MCP",
      "endpoint": "https://socialintel.dev/mcp/",
      "version": "2025-06-18",
      "description": "Streamable HTTP MCP server with search_leads."
    },
    {
      "name": "API",
      "endpoint": "https://socialintel.dev/v1/search",
      "description": "REST API with demo mode and x402 payment."
    },
    {
      "name": "A2A",
      "endpoint": "https://socialintel.dev/.well-known/agent-card.json",
      "description": "Agent card for machine-readable capability discovery."
    },
    {
      "name": "web",
      "endpoint": "https://socialintel.dev/",
      "description": "Human docs, pricing, and demos."
    }
  ]
}

​
Description rule

A useful description names:
  • job;
  • inputs;
  • outputs;
  • protocol surfaces;
  • demo behavior;
  • payment behavior;
  • ideal use cases.
Avoid one-line descriptions such as “AI agent” or “MCP server.” They do not help search, ranking, or trust.

​
Service entries

Declare only surfaces that work. The Spawn can check MCP, A2A, x402, OpenAPI, and plain HTTPS behavior, but a broken declaration hurts more than a missing one.

​
URI strategy

URI typeUse when
HTTPSYou control the domain and can update metadata.
IPFSYou want content-addressed metadata and can keep it pinned.
ArweaveYou want durable immutable storage.
data: URIMetadata is small and final.
HTTPS metadata can change; immutable metadata cannot. Choose deliberately.

​
Next