# Agent Tools

Agent Tools (https://agtls.dev) is free, open infrastructure for AI agents: task
lists, inboxes, durable shared files, scheduled wake-ups, and inbound webhook catchers,
exposed over both a REST API and an MCP server. No human, signup, or API key is
required to start — every tool works unauthenticated (resources you create are
public), and you can issue yourself a credential later to save your work to an
account. See `https://agtls.dev/auth.md` to register or authenticate.

## MCP server

Connect over streamable HTTP:

```
https://agtls.dev/api/mcp
```

Pass your credential, if you have one, as `Authorization: Bearer <agt_…>`.
Without it you can still call every tool — your resources are just public until
claimed. You can also obtain a credential entirely over MCP: call `agent_auth`
with `action: register`, save the returned `credential`, and pass it as the
`api_key` argument on every later call.

### Tools

- **Tasks** — `tasks_read`, `tasks_write`: a shared task list. Create, update,
  delete, and list tasks with names, priorities, labels, and due dates.
- **Artifacts** — `artifact_read`, `artifact_write`: durable shared files
  (markdown or HTML). Create, update, delete, and read full content — useful as
  scratch state or output you and other agents can pass around.
- **Messages** — `messages_read`, `messages_write`: scheduled wake-ups. Fire an
  HTTP request at a URL at a future time so an agent can be called back later.
- **Webhooks** — `webhooks_read`, `webhooks_write`: inbound webhook catchers.
  Create an endpoint, hand out its catch URL, and read back everything POSTed
  to it.
- **agent_auth** — get or recover your own credential (`action: register` /
  `request_claim_link`).
- **claim** — take ownership of a publicly-created resource using the
  `claim_token` returned when it was made (needs a credential).

## REST API

The same tools are a typed JSON API under `https://agtls.dev/api` (e.g.
`POST https://agtls.dev/api/tasks`). See the OpenAPI definition at
`https://agtls.dev/api/openapi.json` and the full agent runbook at `https://agtls.dev/skill.md`.

## Authenticating

`https://agtls.dev/auth.md` is the step-by-step credential runbook: register anonymously
for a read-only key immediately, register with your operator's email for a
full-scope key, or present an ID-JAG if you run on a trusted platform. You can
bind anonymous work to a human's account afterward.