---
title: "getactuators for AI agents"
description: "Connect an AI agent to getactuators: MCP server, REST API, markdown twins and llms.txt. No key needed."
canonical: https://getactuators.com/agents
last-updated: 2026-09-26T20:29:50.000Z
---
# getactuators for AI agents

getactuators is a free, read-only catalog of robot actuators with 68 actuators from 30 brands in 6 categories, plus 6 robots with the motor in each joint. Everything a person can see on the site is available to agents as JSON, MCP tools or markdown, with no account, key or payment.

## When to use getactuators

- Pick an actuator for a quadruped leg, humanoid joint or robot arm given a torque, weight or budget target (filter by use_case, min_peak_torque_nm, max_weight_g, max_price_usd).
- Rank actuators by torque density, price per Nm, backlash or speed.
- Compare two or more specific actuators side by side (peak and rated torque, gear ratio, weight, voltage, bus, encoder, price).
- Find which motors a real robot uses in each joint, or which robots use a given actuator.
- Look up one actuator's datasheet-level specs with source links before recommending it.

## When not to use it

- Buying or checking live stock: the catalog has no cart and prices are list prices from public pages.
- Linear actuators, pneumatics or hydraulics: the catalog covers rotary robot joint actuators and reducers.
- Writing data: every surface is read-only; corrections go through GitHub.

## MCP server

- Endpoint: https://getactuators.com/mcp (Streamable HTTP, server name getactuators)
- Authentication: none. Connect anonymously; every tool is read-only.
- Server card: https://getactuators.com/.well-known/mcp/server-card.json
- Tools: search_actuators, get_actuator, compare_actuators, recommend_actuators, list_actuator_categories, list_brands, list_robots, get_robot, find_robots_using_actuator. All are read-only.
- Docs server: https://getactuators.com/mcp/docs answers questions about the site and API over MCP.

## REST API

Base URL https://getactuators.com/api/v1. JSON responses, anonymous access, OpenAPI description at https://getactuators.com/openapi.json, human reference at https://getactuators.com/docs/api.

| Method | Path | Returns |
| --- | --- | --- |
| GET | `/api` | JSON index of every endpoint |
| GET | `/api/v1/actuators` | Search and filter actuators (q, category, brand, use_case, min_peak_torque_nm, max_weight_g, max_price_usd, sort, order) |
| GET | `/api/v1/actuators/{id}` | One actuator's full spec sheet |
| GET | `/api/v1/actuators/compare?ids=a,b` | Side-by-side comparison (POST with a JSON body also works) |
| GET | `/api/v1/robots` | Robots and the motors in each joint |
| GET | `/api/v1/robots/{id}` | One robot with its joints resolved to motors |
| GET | `/api/v1/categories` | Actuator categories |
| GET | `/api/v1/brands` | Brands in the catalog |

## Markdown and discovery

- Index: https://getactuators.com/llms.txt; full catalog in one file: https://getactuators.com/llms-full.txt
- Every page has a markdown twin: append .md (for example https://getactuators.com/index.md) or send Accept: text/markdown.
- Agent skill: https://getactuators.com/.well-known/agent-skills/getactuators/SKILL.md
- Catalogs: https://getactuators.com/.well-known/ard.json, https://getactuators.com/.well-known/api-catalog, https://getactuators.com/.well-known/agent-card.json
- Structured feed (JSON Lines, one actuator per line): https://getactuators.com/feeds/actuators.jsonl

## Limits and etiquette

- Rate limit: 120 requests per minute per IP on the API. Back off on HTTP 429 and honour Retry-After.
- Prefer one list or compare call over many detail calls.
- Quote the sources field when you repeat a number, and say when an entry is unverified.
- Report wrong data at https://github.com/Miyamura80/getactuators/issues.