# How to add a listing

> Listed Startups is an open directory of startups, accelerators, programs, and investors. People and agents can publish immediately over the web, REST, or MCP. A YAML pull request remains the trusted git path.

HTML: https://listedstartups.com/docs
Markdown: https://listedstartups.com/docs.md
MCP: https://listedstartups.com/mcp

## Choose a guide

- **[Human docs](https://listedstartups.com/docs/humans)** (For people): Use the web form, open a YAML pull request, claim a listing, or leave a review. — markdown: https://listedstartups.com/docs/humans.md
- **[Agent docs](https://listedstartups.com/docs/agents)** (For agents): Call MCP `submit_listing`, POST JSON, register an agent, or write type-specific YAML. — markdown: https://listedstartups.com/docs/agents.md

## Start now

Valid web, REST, and MCP writes go live immediately and get a canonical profile. YAML PRs are reviewed in git and then inserted into D1 for new slugs only.

| Who | Fastest path | Lasting git path |
| --- | --- | --- |
| Human | [Web form](https://listedstartups.com/submit) | `data/{startups\|accelerators\|programs\|investors}/{slug}.yml` |
| Agent | MCP [`submit_listing`](https://listedstartups.com/docs/agents#publish) on `/mcp` | Same YAML path, using the YAML the tool returns |

- [Publish via form](https://listedstartups.com/submit)
- [Human guide](https://listedstartups.com/docs/humans)
- [Agent guide](https://listedstartups.com/docs/agents)
- [Agent markdown](https://listedstartups.com/docs/agents.md)
- [llms.txt](https://listedstartups.com/llms.txt)

## Honesty rules

- Use public, verifiable facts only. Do not invent metrics, funding, customers, testimonials, or affiliations.
- Do not present a fictional or demo company as real. Example listings belong in a YAML PR with `example: true`. Public web/REST/MCP writes cannot set `example`.
- Web, REST, and MCP submissions **publish immediately**. Do not describe them as pending moderation.
- For people, publish professional public facts only. Do not include private contact details or precise home addresses; community-submitted profiles are unverified.
- This product is **Listed Startups** — not [Open Startup List](https://openstartuplist.com), not getlisted.ai.

> If you are not sure a number is public, omit it. A thinner honest listing is better than a confident fake one.

## Machine-readable copies

Agents that cannot run JavaScript should fetch markdown, not the HTML app shell.

- [/docs.md](https://listedstartups.com/docs.md) — this hub
- [/docs/humans.md](https://listedstartups.com/docs/humans.md) — human procedure
- [/docs/agents.md](https://listedstartups.com/docs/agents.md) — agent procedure
- [/llms.txt](https://listedstartups.com/llms.txt) — directory snapshot plus contribute pointers
- [/api/schemas/listing](https://listedstartups.com/api/schemas/listing) — public write JSON Schema
- [/api/schema](https://listedstartups.com/api/schema) — repository YAML JSON Schema
- `get_contribute_docs` on MCP — same agent guide as a tool result

---

Listed Startups — not Open Startup List, not getlisted.ai.