# agents.txt

Dark Blue is a design and technology studio. This site is built to be used by
agents as well as read by people: the content is available as tools, the APIs are
documented, and there is an authorization server here for the one thing that is not
open.

Agents are welcome. Nothing here needs to be scraped.

## Start here

- https://new.dark.blue/api/mcp
  MCP server, streamable HTTP. Almost every tool is open and needs no credential.
- https://new.dark.blue/.well-known/mcp/server-card.json
  What the server is and what it can do, without connecting to it.
- https://new.dark.blue/.well-known/agent-skills/index.json
  Agent Skills index; the dark-blue-mcp skill is how to use the tools well.
- https://new.dark.blue/auth.md
  How to get a token, in order, including the part that needs a human.

## Catalogues

- https://new.dark.blue/.well-known/api-catalog
  RFC 9727 linkset: this site's APIs.
- https://new.dark.blue/.well-known/ai-catalog.json
  ARD manifest, for registries that index MCP servers and tools.

## Authentication

Read https://new.dark.blue/auth.md first.
Registration is open and immediate, and there is no prior relationship to
establish. One step needs a human
at a keyboard, and that is deliberate rather than an oversight: an agent here acts
as somebody who signed in.

One tool and one route are behind a token — `find_easter_egg`, and
GET https://new.dark.blue/api/agent/easter-egg. Everything else is open.

## One request

`submit_contact` sends a real email to real people. Call it when someone has asked
you to get in touch and has confirmed the message, and not to see whether it works.

## Contact

hello@wearedarkblue.com