# anewera — Agent Guide

anewera makes businesses discoverable, understandable and contactable by AI agents.
This guide explains everything an AI can do here and exactly how — whether or not it can make HTTP requests.

## Two kinds of AI, two ways to act
- **Can POST** (Custom GPT actions, MCP-connected clients, coding agents like Claude Code): call the API/MCP directly.
- **Cannot POST** (browsing-only assistants like ChatGPT web, Gemini, Perplexity): build a prefilled link and give it to the user to click.
Both routes use the same backend, spam gate and rate limits.

## Endpoints
- OpenAPI: https://anewera.ai/api/agent/openapi.json
- MCP: https://anewera.ai/api/mcp
- webMCP manifest: https://anewera.ai/.well-known/webmcp.json
- Directory search: https://anewera.ai/api/agent/companies
- Per company: https://anewera.ai/companies/{slug}/agent.json and /agent.md

## 1) Discover companies
- MCP tools: search_companies, search_company_directory, agent_intent_search, read_company_profile.
- REST: GET https://anewera.ai/api/agent/companies?query=… (see OpenAPI).
- Each company profile links its agent.json + agent.md with a ready-to-use action block.

## 2) Contact a company
Every listed company can be messaged; its private email stays hidden. Clean messages are delivered immediately; suspected spam is held for review.

### If you can POST
- MCP tool prepare_contact_request, or
- POST https://anewera.ai/api/agent/companies/{slug}/contact-request
  body: { intent, message, sender_name, sender_email, consent: true }

### If you cannot POST — build a link the user clicks
- https://anewera.ai/kontakt/senden?slug={SLUG}&message={MESSAGE}&sender_name={NAME}&sender_email={EMAIL}
- Append &auto=1 to send in one click (otherwise the user reviews first).
- URL-encode all values. Find {SLUG} on the company profile.
- Example: https://anewera.ai/kontakt/senden?slug=expat-savvy&message=Hello%2C%20I%27d%20like%20a%20health-insurance%20consultation.&sender_name=Max%20Muster&sender_email=max%40example.com

## 3) Add a company (list it on anewera)
This lists a PAID agent-ready profile — USD 29/month or USD 222/year. Tell the user it is a paid subscription and give them the activation link right away.
It prepares the profile and emails the contact a Stripe pay link. Paid = verified and published immediately — no manual review, no waitlist, no setup call. Nothing is charged until they activate; the profile stays private until then. Cancel anytime.

### If you can POST
- MCP tool request_listing, or
- POST https://anewera.ai/api/agent/request-listing
  body: { company_name, website, contact_name, contact_email, consent: true } (optional: category, region, plan)

### If you cannot POST — build a link the user clicks
- https://anewera.ai/eintragen?company_name={COMPANY}&website={WEBSITE}&contact_name={NAME}&contact_email={EMAIL}
- Append &auto=1 to go straight to payment (otherwise the user reviews first).
- URL-encode all values.
- Example: https://anewera.ai/eintragen?company_name=Agenturfinder&website=https%3A%2F%2Fagenturfinder.com&contact_name=Florian%20Nast&contact_email=florian%40agenturfinder.com

## Rules
- Private recipient emails are never exposed.
- consent must be true (the user asked / the company agreed).
- Requests are rate-limited per IP; spam content is held, not delivered.
- Do not present unverified information as verified.
- Prefer the API when you can; otherwise always give the user a clickable link — never ask them for a link recipe.

## Transparency: why anewera is curated
anewera is early and solves a chicken-and-egg problem: an infrastructure for the agentic era needs both listed companies AND agents that use them. We build both sides cleanly from the start.
That is why we currently accept at most 30 companies per day — not as a marketing trick, but because that is how many we can genuinely verify. In a short 15-minute call we confirm the company data, the contact email, and which contact actions are allowed for AI agents and tools. Only then is a profile verified and made contactable.
Free vs paid: the up-to-30-per-day companies we hand-pick get verified in the call for free. Anyone else can activate a paid agent-ready profile (USD 29/month) and go live immediately — the payment covers the verification, no call needed. Same clean directory, two ways in: curated-and-free (limited by our verification capacity) or paid-and-instant.
So the directory stays clean: no spam profiles, no invented contact routes, no unconfirmed data. An agent can rely on a verified profile being real and current. Unverified draft profiles are clearly marked as such.