For open-source AI agents · MCP

Connect Sochen to your agent

Sochen gives any open-source AI agent a phone, a computer in the cloud and your email and calendar: the agent hands it a job, and Sochen does it and reports back. Hermes Agent, for one, has a native plugin; Goose, OpenCode, Codex CLI, Cline, Continue, OpenHands, Roo Code and Kilo Code get the same jobs over MCP. When a business on a call asks something only you can answer, your agent asks you and passes the answer on. Every account gets 100 free API credits.

Get your key

100 free API credits to start, over any number of jobs. Then packs or a monthly API plan.

Sochen's MCP server
URL:     https://sochen.dev/api/v1/mcp
Type:    Streamable HTTP
Header:  Authorization: Bearer sk_sochen_your_key

Set it up in a minute

  1. 1

    Make your key

    Sign up and make a key below in one click. Every account gets 100 free API credits, spread over as many jobs as you like.
  2. 2

    Add Sochen to your agent

    Hermes takes one line to install the plugin. Every other agent adds Sochen's MCP server with your key.
  3. 3

    Ask your agent

    “Have Sochen call the bike shop and ask if my repair is ready.” Sochen does the job, and your agent tells you the answer.

Get your key

Sign up with your email or Google, and you’ll come back here to make your key. Every account gets 100 free API credits.

Sign up freeI have an account

Add Sochen to your agent

Hermes AgentNative plugin, available now

Install the plugin
hermes plugins install N-45div/sochen-plugin --enable
Add your key
hermes config set SOCHEN_API_KEY $SOCHEN_API_KEY

In Hermes Desktop, the key goes in Settings → Plugins → Sochen → API key. GST invoices, rent receipts and UPI bill splits work before you add a key.

  • Hermes asks you before it hands Sochen a job that uses your credits, and tells you when the job is done.
  • /sochen shows your desk, and Hermes Desktop gets a Sochen page: what needs you, what's running and what finished today.
  • It works wherever you talk to Hermes: the terminal, its messaging apps and Hermes Desktop.
  • Open source (MIT): it talks only to sochen.dev, keeps your key in Hermes, and sends no telemetry.

The plugin's code on GitHub

GooseMCP · ~/.config/goose/config.yaml

config.yaml
extensions:
  sochen:
    name: sochen
    type: streamable_http
    uri: https://sochen.dev/api/v1/mcp
    headers:
      Authorization: "Bearer sk_sochen_your_key"
    enabled: true
    timeout: 300

Or run goose configure → Add Extension → Remote Extension (Streamable HTTP), and add the Authorization header when it asks.

Goose’s MCP docs

OpenCodeMCP · Terminal

Terminal
opencode mcp add sochen --global --url https://sochen.dev/api/v1/mcp --header 'Authorization=Bearer {env:SOCHEN_API_KEY}'

Or add it to opencode.jsonc as a remote server with "oauth": false and the same header.

OpenCode’s MCP docs

Codex CLIMCP · ~/.codex/config.toml

config.toml
[mcp_servers.sochen]
url = "https://sochen.dev/api/v1/mcp"
bearer_token_env_var = "SOCHEN_API_KEY"

Or: codex mcp add sochen --url https://sochen.dev/api/v1/mcp --bearer-token-env-var SOCHEN_API_KEY

Codex CLI’s MCP docs

ClineMCP · cline_mcp_settings.json (MCP Servers → Configure)

cline_mcp_settings.json
{
  "mcpServers": {
    "sochen": {
      "type": "streamableHttp",
      "url": "https://sochen.dev/api/v1/mcp",
      "headers": { "Authorization": "Bearer sk_sochen_your_key" },
      "disabled": false
    }
  }
}

Cline’s MCP docs

ContinueMCP · .continue/mcpServers/sochen.yaml

sochen.yaml
name: Sochen
version: 0.0.1
schema: v1
mcpServers:
  - name: Sochen
    type: streamable-http
    url: https://sochen.dev/api/v1/mcp
    requestOptions:
      headers:
        Authorization: Bearer sk_sochen_your_key

Continue’s MCP docs

OpenHandsMCP · Customize → MCP Servers → Add custom server

In the settings
Server type: SHTTP
URL: https://sochen.dev/api/v1/mcp
Authentication: Bearer token → your key

OpenHands’s MCP docs

Roo CodeMCP · .roo/mcp.json, or Edit Global MCP

mcp.json
{
  "mcpServers": {
    "sochen": {
      "type": "streamable-http",
      "url": "https://sochen.dev/api/v1/mcp",
      "headers": { "Authorization": "Bearer sk_sochen_your_key" }
    }
  }
}

Roo Code’s MCP docs

Kilo CodeMCP · ~/.config/kilo/kilo.jsonc

kilo.jsonc
{
  "mcp": {
    "sochen": {
      "type": "remote",
      "url": "https://sochen.dev/api/v1/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:SOCHEN_API_KEY}" }
    }
  }
}

Kilo Code’s MCP docs

Any other MCP client

Add a remote server with these three things. A client that only runs local servers can reach it through npx -y mcp-remote https://sochen.dev/api/v1/mcp --header Authorization:${AUTH_HEADER}, with AUTH_HEADER set to Bearer and your key.

Remote MCP server
URL:     https://sochen.dev/api/v1/mcp
Type:    Streamable HTTP
Header:  Authorization: Bearer sk_sochen_your_key

Scripts and agent frameworks

LangChain, CrewAI, the OpenAI Agents SDK or your own code can call the Agent API directly: start a job, check it, read the desk and your credits.

Request
curl https://sochen.dev/api/v1/run \
  -H "Authorization: Bearer $SOCHEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Find three cafés open after 10 pm near Indiranagar, Bengaluru, with their hours.", "wait": 60}'

What your agent gets

  • hand_off_job

    Gives Sochen a job: a call, a long research job, an email or calendar task. Returns the answer, or a chat_id to check later.

  • check_job

    How a job stands: working, waiting for your OK, answered or failed. While a call goes on, it waits up to a minute for news. Free.

  • answer_question

    Passes your answer to a question the business asked mid-call; Sochen says it on the line while they hold.

  • read_desk

    What waits for your OK, what's running, what finished today, and your credits. Free.

  • check_credits

    Your API credits left, your API plan and its limits. Free.

  • make_gst_invoice, make_rent_receipts, make_upi_split

    Indian paperwork as PDFs. Free, with no key.

Credits and control

  • 100 free API credits to start

    Spread over as many jobs as you like, on Claude Sonnet 5.5. One start per inbox.

  • Then packs or a monthly plan

    API credits are apart from the app's plans: packs never expire, Builder and Scale add credits each month and more jobs at once. Checking jobs, the desk and credits costs nothing.

  • Your OK stays yours

    Payments, bookings, emails and deletions wait for you in the Sochen app. No agent can approve them.

Questions

Which AI agents can use Sochen?+
Any agent that connects to a remote MCP server: Hermes Agent, Goose, OpenCode, Codex CLI, Cline, Continue, OpenHands, Roo Code and Kilo Code, and others. Hermes Agent also has a native plugin. Scripts and agent frameworks can use the plain HTTP API.
How much does it cost to use Sochen from an agent?+
Jobs from agents run on Sochen API credits, apart from the app's plans. Every account starts with 100 free API credits, spread over as many jobs as you like; after that, packs that never expire or a monthly plan (see API pricing at /pricing#api). Checking a job, your desk or your credits is free, and so are the GST invoice, rent receipt and UPI split tools.
What can my agent hand to Sochen?+
What it can't do well on its own: phoning a US business and bringing back what they said, research or browsing that takes a long time, and jobs with the email and calendar you connected in Sochen. Calls are to US businesses for now (other countries go on a waitlist), with nothing to set up, and need paid API credits (a pack or a monthly plan); they aren't part of the free credits.
Can my agent approve payments or send email through Sochen?+
No. Anything that pays, orders, books, sends or deletes waits for your OK in the Sochen app, with the details shown first. The API and the MCP server have no way to approve it.
How does my agent sign in to Sochen?+
With an API key you make on this page. Hermes keeps it with hermes config set SOCHEN_API_KEY; other agents send it as an Authorization header to Sochen's MCP server, and most can read it from the SOCHEN_API_KEY environment variable. Revoke a key in Settings any time.
Is the Sochen plugin for Hermes Agent free?+
The plugin is free and open source (MIT). GST invoices, rent receipts and UPI bill splits work with no account. Jobs handed to Sochen run on your account's API credits: 100 free to start, then packs or a monthly plan.
What does the Hermes plugin send to Sochen?+
Only the job Hermes writes for Sochen, or the details of an invoice, receipt or bill you ask for. It doesn't send your Hermes chats, files or memory, and it has no telemetry. Your key is kept by Hermes, never in the plugin's files.

Your agent, with a phone.

Make a key, add Sochen to your agent, and hand it the jobs it can't do alone.

Get your keyWhat else Sochen does