# Darwin integrations

Public, self-serve installation artifacts for Darwin's production MCP server:

```text
https://mcp.darwin.so/mcp
```

The server dynamically advertises the canonical seven-tool Search → Act contract. These examples never copy a static tool schema into an agent framework; clients call MCP `tools/list` at runtime so tool metadata stays current.

## Install now

- [Generic remote MCP configuration](configs/generic-mcp.json)
- [VS Code workspace configuration](configs/vscode-mcp.json)
- [Cursor configuration](configs/cursor-mcp.json)
- [Client-by-client installation guide](clients/README.md)
- [n8n MCP workflow template](templates/n8n/darwin-mcp-agent.json)
- [Gumloop reusable-node recipe](templates/gumloop/README.md)
- [Framework recipes](frameworks/README.md)

The separate [Gemini CLI extension](https://github.com/darwin-studios/darwin-gemini-cli) is installable with:

```bash
gemini extensions install https://github.com/darwin-studios/darwin-gemini-cli
```

Darwin is also active in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=so.darwin/darwin) as `so.darwin/darwin`.

## Verify the public contract

```bash
npm install
npm run smoke
```

`npm run smoke` initializes a real production MCP session, discovers tools dynamically, and asserts the seven canonical tool names. To also run one authenticated, read-only Search without putting a secret in source control, set `DARWIN_ACCESS_TOKEN` in the process environment.

## Safety boundary

- Search is read-only. Action mutations are separate tools.
- A successful model turn is not proof that an Action completed; read the Action state.
- Never put Darwin tokens, provider credentials, payment data, or approval material in prompts, workflow exports, URLs, or committed configuration.
- Preserve `capabilityRevision`, `actionId`, and mutation `requestId` outside model prose.
- Close MCP clients in `finally` blocks and refresh tools when the contract changes.

Marketplace artifacts that require vendor review are intentionally not submitted from this repository. Darwin documentation labels those separately as `Submission ready`, `Submitted`, or `Approved`.

## Release status

| Artifact | Status | Verification |
| --- | --- | --- |
| Production MCP endpoint | Install now | MCP initialization and seven-tool discovery |
| Official MCP Registry | Install now | Active as `so.darwin/darwin` version `0.7.0` |
| Gemini CLI extension | Install now | Public `v0.1.0`; gallery indexing is automatic via the repository topic |
| Cursor and VS Code configs | Install now | Generated from each client's documented remote-MCP format |
| Framework recipes | Install now | Dynamic-discovery and cleanup invariants checked; framework packages remain version-pinned by adopters |
| n8n workflow | Install now | Export shape and current MCP Client Tool v1.4 parameters validated; credentials intentionally absent |
| Gumloop recipe | Install now | Manual reusable-node setup; Gumloop provides no credential-free portable node export |