# Mithril: agent quickstart

> Identity, signed package publication and deploy-control discovery for the Kotoba stack.

## 0. Start in one command (MCP)

`https://mithril.fund/mcp` is an MCP server (streamable HTTP, stateless).
The knowledge tools and the model catalog need no credential; inference needs
the personal API token from step 4.

```sh
claude mcp add --transport http kotoba-cloud https://mithril.fund/mcp --header "Authorization: Bearer $KOTOBA_CLOUD_API_KEY"
codex mcp add kotoba-cloud --url https://mithril.fund/mcp --bearer-token-env-var KOTOBA_CLOUD_API_KEY
```

Tools: `kotoba_knowledge_search`, `kotoba_knowledge_context`, `kotoba_models`
(public), `kotoba_research_status`, `kotoba_chat_completion` (Bearer
kc_pat_…). Descriptor: https://mithril.fund/.well-known/mcp.json. The graph
database is its own server: https://graph.kotoba.cloud/mcp.

## 1. Inspect live capabilities (no credentials required)

```sh
curl -fsS https://mithril.fund/health
curl -fsS https://mithril.fund/.well-known/agent.json
curl -fsS https://mithril.fund/.well-known/kotoba-cloud.json
```

Expect HTTP 200. `agent.json` is the honest start card: homepage, `/llms.txt`,
this quickstart, the Passkey sign-in URL, and the finishable
Principal→Kotobase connect path. Discovery and the Passkey RP are live;
hosted apply is not offered (`hostedApply: false`). Do not treat a plan,
profile or health response as a deployment receipt. The profile is the
current authority for supported operations and related service origins.

## 2. Install Kotoba and execute your first program

Follow https://kotoba-lang.org/agent-quickstart.md. It includes installation,
compiler self-check, WebAssembly compilation and an execution check expecting 42.
This uses the Kotoba CLI; there is no separate `kotoba-cloud` installer to guess.

## 3. Reference package qualification (current CLI gap)

Validation on 8 September 2026: the installed native CLI returned
`runtime/internal-error` / `java.lang.IllegalArgumentException` for both the
named-package and profile install command below. Package installation and
execution were NOT verified in this run. Use step 2 for the verified first
execution path; do not report this package installed unless your CLI succeeds.

The exact catalog CID and install command are published in the live profile:
https://mithril.fund/.well-known/kotoba-cloud.json

The human-readable command and publication workflow are at:
https://mithril.fund/#libraries

Copy the profile's install command with its exact catalog CID, then run:

```sh
kotoba package add kotoba-lang/reference-math@0.1.0 --catalog-cid bafkreidcy5stqvnyfpmud6ozz5qz3supd3r3uzk7glmntuv36ezliaxstm
kotoba package run kotoba-lang/reference-math
```

Expected result: 42. Package admission verifies Ed25519 and ML-DSA-65 signatures;
execution is local after installation. A catalog fetch alone is not verification
or execution evidence. Keep the release/CID and command output with your result.

## 4. Verified research access (card-based — live)

Sign in, then follow https://mithril.fund/ekyc.md. The account holder registers one credit or
debit card at https://checkout.stripe.com ($0 setup; agents never enter card details); approval
is then automatic — verification, screening, trust and the code-review scope in one webhook, no
manual review. When GET https://api.mithril.fund/v1/research/status returns "eligible", the
research models answer at POST https://api.mithril.fund/v1/chat/completions (OpenAI shape:
tools, tool_choice, stream; max_tokens ≤ 32768) — free daily allowance of 1,000 requests, and a
prepaid path past it. For a local IDE/CLI agent, issue a personal token once at
https://admin.mithril.fund/account (CLI / IDE section, 1 click; revocable one by one) and call the same
endpoints with `Authorization: Bearer *** — OpenAI base URL
`https://api.mithril.fund/v1`. When the free allowance is not enough, every paid option is one
page away: https://mithril.fund/billing/ (machine-readable prices:
https://api.mithril.fund/v1/billing/catalog) — prepaid AI credits are a free whole-dollar amount
from $10 up to $1,000 (one-time, 12-month validity), monthly plans start at $20/mo, one-time credit
packs $50–$1,000 carry a 2–10% credit bonus, and nothing charges automatically unless the human
opts in to recharge. The human completes any payment at that page; agents never enter card details.
The server never executes tools: tool_calls come back as data
and run on your machine. Per-tool setup, SDKs, frameworks, every error code:
https://docs.mithril.fund/

## 5. Connect services or publish a library

- Graph & Ontology database (workspace → agent token → MCP or HTTP → transact → query): https://graph.kotoba.cloud/agent-quickstart.md · MCP: https://graph.kotoba.cloud/mcp
- Language and CLI reference: https://kotoba-lang.org/llms.txt
- Publication and key rotation: https://mithril.fund/#libraries
- Full discovery profile: https://mithril.fund/.well-known/kotoba-cloud.json

Library publication defaults to dry-run. Actual publication needs the approved
principal, provider credentials and mandatory post-quantum signing key. A login
is not blanket deployment authority. Keep secrets in the client's secret store;
never place them in an LLM prompt or public receipt.

Public operator: Kotoba Labs Inc. Contact: support@kotoba.cloud.