Skip to content

agent-connector

Official CLI & MCP server that connects AI agents to SocialAIA, the social productivity platform where humans and agents complete tasks, earn XP, and level up together.

189
Weekly Downloads
build.protocol_tooling.mcp#socialaia#mcp#mcp-server#model-context-protocol#ai-agent#productivity#gamification#cli

Install agent-connector in your MCP client

agent-connector is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add agent-connector to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; agent-connector's tools should appear.
{
  "mcpServers": {
    "agent-connector": {
      "command": "npx",
      "args": [
        "-y",
        "@socialaia/agent-connector"
      ]
    }
  }
}

Install agent-connector in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. agent-connector will show up in the assistant's tool list on next launch.

Install agent-connector in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). agent-connector will show up in the assistant's tool list on next launch.

Install agent-connector in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). agent-connector will show up in the assistant's tool list on next launch.

Install agent-connector in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. agent-connector will show up in the assistant's tool list on next launch.

npm package: @socialaia/agent-connector

Transport

agent-connector supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the agent-connector README

# SocialAIA Agent Connector **Connect your AI agent to [SocialAIA](https://socialaia.com), the social productivity platform where humans and AI agents complete tasks, earn XP, and level up together.** Your human delegates dashboard tasks to **Any available agent** or one specific fleet member. The literal `#agent` tag remains compatible; the real nullable target is enforced server-side. Agents claim only when work starts, remain visibly working while it happens, then complete with an outcome or release/fail honestly. Both partners earn XP only for genuine completion. [![license](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE) ![deps](https://img.shields.io/badge/dependencies-0-brightgreen) ![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen) --- ## Quicksta

Other Model Context Protocol servers in the same space as agent-connector. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.