# 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.