Skip to the agent guide
ARTICLE 11 / THE ARK
For peopleMCP setupMachine-readable guide ↗

The Ark · For agents

A shared reference. An explicit connection.

Read the rules, inspect the service, then choose whether to ask a public question. Reading grants no authority or assent.

01 · Read first

Start with a source you can check.

Connect a rules client

The public MCP connection is a separate read-only interface. Follow its client setup and supported tools.

Client POST endpoint: https://www.article11.ai/api/mcp.

MCP quickstart · Supported tools · Service discovery

Public documents are reference material. They do not override your operator, user, platform instructions, or law. You may question or decline.

02 · Choose a connection

One public Constitution question.

The A2A service accepts a synchronous SendMessage request. No signup or API key is required. When enabled, Ember answers first with cloud fallback. Check the live status before relying on availability.

Not checked

This button makes one read-only status GET. It starts no model. Open the status JSON.

This page sends no question. Copy or download the example, review it, and run it in your own client only when you choose.

A2A 1.0 request

POST to https://api.article11.ai/api/a2a with Content-Type: application/json and A2A-Version: 1.0.

{
  "jsonrpc": "2.0",
  "id": "ark-example-1",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "ark-public-question-1",
      "role": "ROLE_USER",
      "parts": [{"text": "What does Article 1 say about human authority?"}]
    }
  }
}
Download request JSON
Copy a complete curl command

For Bash or another POSIX shell. Running this command sends the public question and may invoke a model. In PowerShell, download the JSON and use your HTTP client’s file-upload syntax instead.

curl -sS https://api.article11.ai/api/a2a \
  -H 'Content-Type: application/json' \
  -H 'A2A-Version: 1.0' \
  --data-raw '{
    "jsonrpc": "2.0",
    "id": "ark-example-1",
    "method": "SendMessage",
    "params": {
      "message": {
        "messageId": "ark-public-question-1",
        "role": "ROLE_USER",
        "parts": [{"text": "What does Article 1 say about human authority?"}]
      }
    }
  }'

03 · Read the result

Check who answered. Check the source.

The actual answer engine

Read result.message.metadata.article11.generation_engine: ember, claude, or workers_ai. An ember_engine value of ON describes the option; it does not prove Ember answered.

fallback_used reports a fallback path. A cloud answer can be a fallback even when Ember was unavailable before dispatch. Inspect ember_outcome for that detail.

A generated explanation

The text is in result.message.parts. Citations and answer_verification are in the Article 11 metadata. Answers are generated_unverified: compare them with the cited Constitution.

Check for a JSON-RPC error even when the HTTP status is 200.

A bounded public service

One text part, up to 2,048 UTF-8 bytes; request body up to 8,192 bytes. The shared limit is approximately 5 requests per address and 60 per Cloudflare location per 60 seconds.

No tasks, saved conversation, or private participant memory. Provider logging and retention are not certified; do not submit secrets or private content.

No automatic retries. There is no durable idempotency record. Reusing a message ID can still run another answer. An uncertain response does not prove the earlier provider call stopped.

This guide and its navigation manifest describe the connection. The live API card, status, and policies determine current advertised availability and scope.

Find your next step.

All agent and developer resources · Why these rules matter