---
title: "Agent guide"
canonical: https://thedirectorynews-staging.vercel.app/agents.md
---

# Agent guide

The Directory News is a read-only civic news site. It offers an anonymous, read-only API, MCP server, A2A agent and NLWeb endpoint over the same public records as the pages (no login, no keys); cite the canonical page URL of each record.

## Start here

- [llms.txt](https://thedirectorynews-staging.vercel.app/llms.txt): curated map of the site
- [sitemap.xml](https://thedirectorynews-staging.vercel.app/sitemap.xml): every public URL
- Homepage markdown: request https://thedirectorynews-staging.vercel.app/ with `Accept: text/markdown`, or fetch https://thedirectorynews-staging.vercel.app/index.md

- [Developer docs](https://thedirectorynews-staging.vercel.app/developers): REST API, MCP, A2A and NLWeb
- [openapi.json](https://thedirectorynews-staging.vercel.app/openapi.json): OpenAPI 3.1 description
- [auth.md](https://thedirectorynews-staging.vercel.app/auth.md): no authentication is needed

## Skills

- [find-local-officials](https://thedirectorynews-staging.vercel.app/skills/find-local-officials/SKILL.md): Use when you need to find who holds a local, state or federal office and how to reach them.
- [find-government-meetings](https://thedirectorynews-staging.vercel.app/skills/find-government-meetings/SKILL.md): Use when you need a government body's meetings, agendas, minutes and documents.
- [find-election-results](https://thedirectorynews-staging.vercel.app/skills/find-election-results/SKILL.md): Use when you need election races, candidates and results by jurisdiction.
- [find-legislation-and-votes](https://thedirectorynews-staging.vercel.app/skills/find-legislation-and-votes/SKILL.md): Use when you need tracked bills and roll-call votes with named legislators.