Connect over MCP

A remote MCP server: Streamable HTTP, read-only, deterministic answers. No key and no sign-up during the beta.

https://agile-today.org/api/mcp

Setup

Add the URL to your client and the agent sees 8 tools and three ready-made prompts.

Claude

Settings → Connectors → Add custom connector → paste the URL.

URL

https://agile-today.org/api/mcp

Claude Code

One command in the terminal:

Terminal

claude mcp add --transport http agile-today https://agile-today.org/api/mcp

Cursor and other clients

Add the server to the MCP config (for example .cursor/mcp.json):

mcp.json

{
  "mcpServers": {
    "agile-today": {
      "url": "https://agile-today.org/api/mcp"
    }
  }
}

VS Code

Add the server to .vscode/mcp.json or run “MCP: Add Server”:

.vscode/mcp.json

{
  "servers": {
    "agile-today": {
      "type": "http",
      "url": "https://agile-today.org/api/mcp"
    }
  }
}

Tools

Every tool is annotated readOnlyHint. The usual order of calls:

list_context
plan_project
check_gate
validate_plan

list_context

Call first: dimensions, flags, stages, gates, precedence.

plan_project

Route for a context. Compact by default (about 6–10k characters); one stage in full on request.

check_gate

Gate verdict with the rule that fired, questions and a receipt hash.

when_to_use

Does an item fit here, how strongly and why; antipatterns are flagged.

check_mix

Antipatterns, conflicts, redundant alternatives, missing inputs in a set.

validate_plan

Order, types, contract timing, antipatterns in an ordered plan.

search_graph

Search in English and Russian, typo-tolerant.

explain_node

One node with all links and link ids (Lxxxx) to cite.

Prompts: plan-project, run-gate, review-plan.

Details

Response format

Every tool answers with one envelope. On error data is null and errors carry the field, the message and did_you_mean.

{
  "graph_version": "2.3.1",
  "content_hash": "43a51781ec9202f0",
  "lang": "en",
  "context": {
    "dom": "software",
    "ap": "hybrid",
    "…": "…"
  },
  "data": {
    "…": "…"
  },
  "warnings": [],
  "errors": []
}

Versions and receipts

Graph versions follow SemVer: major when gate requirements or conditions change, minor for new nodes and links, patch for wording. Link ids are stable; removed ids are never reused. check_gate returns a hash of its inputs: the same input on the same version gives the same verdict.

Fair use

The beta is free for people and agents. The descriptive layer of the graph is open under CC BY 4.0, so there is no need to collect it by enumerating calls: download /api/graph or the agile-today-graph repository on GitHub. For agents: llms.txt.