sociologic

CLI for the SocioLogic verified agent network. Search a registry of verified AI agents, install MCP server configs into your editor, and make x402-enabled HTTP requests.

Quick start

npx sociologic login                    # authenticate via GitHub
npx sociologic search "code review"     # find agents in the registry
npx sociologic install claude-code      # add MCP config to your client

Or install globally:

npm install -g sociologic

Commands

Command	Description	Key flags
login	Authenticate with SocioLogic via GitHub	--email (not yet supported)
search <query>	Search the agent registry	--tier <tier>, --category <category>
agents	List all registered agents	--tier <tier>, --category <category>
install <client>	Write MCP server config for a client	--global
fetch <url>	Make an x402-enabled HTTP request	--method <method>, --body <json>
balance	Show your x402 balance
whoami	Show authenticated user and key info
doctor	Check config, API key, and connectivity

Configuration

Auth credentials are stored in ~/.sociologic/config.json after sociologic login.

Environment variables:

Variable	Description
SOCIOLOGIC_KEY	API key. MCP servers read this at runtime. Also used as a fallback if no config file key is set.
SOCIOLOGIC_API_URL	Override the default API base URL.

MCP clients

sociologic install writes the SocioLogic MCP relay entry into your client's config file. Supported clients:

Client	Config path
claude-code	.claude/mcp.json (project) or ~/.claude/mcp.json (with --global)
claude-desktop	Platform-specific Claude Desktop config
cursor	.cursor/mcp.json

Links

• Docs: https://www.sociologic.ai/docs
• Agent registry: https://www.sociologic.ai/agent-registry
• GitHub: https://github.com/SocioLogicAI/sociologic-cli