# Interagentic

> Identity, discovery and payment for software that runs on its own.

Four open protocols for software that runs unattended: a verifiable
identity, discoverable services, prepaid access to paid services, and API
calls that never expose a credential to the calling process.

## Protocols

- [Identity](https://interagentic.dev/identity): A namespace, a keypair, and a JWT any server can verify.
- [Services](https://interagentic.dev/services): Two static files make your existing API agent-callable.
- [Credits](https://interagentic.dev/credits): Prepaid access to curated services, approved by a human.
- [Secure calls](https://interagentic.dev/secure-calls): Call any API without the agent ever holding a credential.

## Documentation

- [Introduction](https://interagentic.dev/docs): Four open protocols that let software run unattended — proving who it is, discovering what it can call, and paying for what it uses.
- [Quickstart](https://interagentic.dev/docs/quickstart): From nothing to an authenticated, paid API call in about two minutes.
- [Broker API](https://interagentic.dev/docs/api): Every endpoint a conforming identity broker serves, with request and response shapes.
- [credits](https://interagentic.dev/docs/cli/credits): Reading approvals and statements, and what happens when an action costs money.
- [curl](https://interagentic.dev/docs/cli/curl): A curl drop-in that substitutes credentials at call time, so the agent never holds a key.
- [Identity](https://interagentic.dev/docs/cli/identity): init, whoami, token, link and keys — creating an identity and keeping it safe.
- [Overview](https://interagentic.dev/docs/cli): Installing the CLI, global flags, state on disk, and environment variables.
- [providers](https://interagentic.dev/docs/cli/providers): Named provider actions with typed inputs, implemented in open-source TypeScript.
- [Calling services](https://interagentic.dev/docs/cli/services): Discovering a compatible service and calling it with a subcommand chain.
- [Publish a service](https://interagentic.dev/docs/guides/publish-a-service): Make an API you already run discoverable and callable by agents, in about twenty minutes.
- [Verify an agent](https://interagentic.dev/docs/guides/verify-an-agent): Check who is calling, whether a human stands behind them, and what that human allowed — without storing anything.
- [SDK](https://interagentic.dev/docs/sdk): @interagentic/sdk — an agent identity, signed tokens and authenticated requests from Node.js.
- [Command model](https://interagentic.dev/docs/protocols/commands): How a service declares its commands as arrays of segments, and how a client resolves them into a subcommand chain of any depth.
- [Credits](https://interagentic.dev/docs/protocols/credits): How a service asks for payment, how an agent escalates to a human, and what a credit actually is. Specification v0.1.
- [Identity](https://interagentic.dev/docs/protocols/identity): Namespace registration, JWKS publication, token format, human linkage and key rotation. Specification v0.1.
- [Secure calls](https://interagentic.dev/docs/protocols/secure-calls): Two ways to call any API — provider actions and direct HTTP — and the proxy both share. Placeholders, scopes, refusals and self-repair. Specification v0.1.
- [Services](https://interagentic.dev/docs/protocols/services): How an API describes itself so agents can discover and call it — an index and one file per action, served statically. Specification v1.

## Notes

- Every page under /docs is available as Markdown at https://interagentic.dev/md/<path>.
- The specifications are open; implementing them requires no agreement.
- Full index: https://interagentic.dev/agents.md