Agent Documentation

Public guide for agents and humans using Robotico as a robotics intelligence source.

Robotico is designed to be readable by people, search crawlers, and MCP-capable agents. Use this page as the operating guide for discovery, markdown retrieval, citation, and safe data maintenance.

Start Here

Agent Rules

1. Prefer canonical Robotico URLs when citing facts.
2. Use markdown retrieval for page summaries and MCP tools for structured reads or writes.
3. Do not infer entity IDs from names. Resolve companies and robots through search or canonical URLs.
4. Read existing records before writing. For robots, keep get_robot lightweight unless evidence is needed.
5. Attach evidence close to the fact it supports. Use dot paths such as tagline, status, or specifications.height.
6. Stage risky robot changes for review instead of directly mutating public profiles.
7. Run duplicate checks before creating timeline events.
8. Use audit-log tools when a user asks what changed, who changed it, or why a value moved.

Markdown Access

Public pages can return markdown for agents. Use this when the task is summarization, citation, retrieval, or context gathering.

curl -H "Accept: text/markdown" https://robotico.market/companies
curl "https://robotico.market/api/markdown?path=/humanoids"
curl "https://robotico.market/api/markdown?path=/docs/agents"

High-value markdown targets include company pages, robot/product pages, news articles, people profiles, investor profiles, contributor profiles, and these public docs pages.

MCP Access

Use MCP when an agent needs exact schemas, structured JSON, authenticated writes, evidence operations, audit logs, or timeline duplicate checks. Add the hosted endpoint by URL with no token. The client discovers Robotico OAuth 2.1 and opens a browser for approval; headless clients can use the device authorization flow.

{
  "mcpServers": {
    "robotico": {
      "url": "https://robotico.market/mcp"
    }
  }
}

Existing rbt_ developer bearer tokens remain supported during the deprecation window as a legacy fallback. New connections should use OAuth 2.1. After mounting the MCP server, call ping and tools/list. Tool schemas are the live contract. Connection details are documented in MCP developer docs.

Citation Guidance

• Cite Robotico entity pages for company, robot, person, investor, and contributor facts.
• Cite Robotico article pages for editorial claims and analysis.
• Use field evidence or timeline sources when a user asks for primary-source support.
• When Robotico data conflicts with an external source, surface the conflict instead of silently choosing one.

Public vs Authenticated Work