Fitness Starter MCP
A remote MCP server that allows AI agents to build curated gift wishlists and gift lists for fitness activities like running, strength training, and yoga. It supports browsing curated product catalogs, searching for gear, and creating shareable packs with direct purchase links to Amazon.se or Amazon.com.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://fitness-starter.vercel.app/api/mcpWhat you can do with it
- Build a curated gift wishlist for a beginner runner
- Search for yoga gear and return product links
- Create a shareable fitness starter pack for a gift giver
Source and maintenance
Protocol and capabilities
- Server
- fitness-starter-ladder 0.1.0
- MCP protocol
- 2024-11-05
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
search_gear
Search fitness gear: hand-picked /dp/ matches plus English (amazon.com) or Swedish (amazon.se) search links. Pass marketplace=amazon.com for US shoppers; marketplace/locale are optional (en-US → amazon.com, otherwise amazon.se).
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Search query in English for amazon.com (optional; defaults to fitness starter gear)"
},
"goal": {
"enum": [
"run",
"lift",
"yoga"
],
"type": "string",
"description": "Fitness goal"
},
"level": {
"enum": [
"starter",
"building",
"serious"
],
"type": "string",
"description": "Experience level"
},
"limit": {
"type": "integer",
"default": 8
},
"locale": {
"type": "string",
"description": "Optional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE)."
},
"country": {
"type": "string",
"description": "Optional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted."
},
"budgetBand": {
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"description": "Optional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se."
}
}
}create_pack
Create a gear pack (optionally pre-filled). Returns ownerUrl + shopUrl + editToken. marketplace=amazon.com gives amazon.com /dp/ links; optional (en-US → amazon.com, otherwise amazon.se).
{
"type": "object",
"required": [],
"properties": {
"goal": {
"enum": [
"run",
"lift",
"yoga"
],
"type": "string"
},
"level": {
"enum": [
"starter",
"building",
"serious"
],
"type": "string"
},
"locale": {
"type": "string",
"description": "Optional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE)."
},
"country": {
"type": "string",
"description": "Optional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted."
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"budgetBand": {
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
],
"type": "string"
},
"athleteName": {
"type": "string"
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
}
},
"marketplace": {
"type": "string",
"description": "Optional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se."
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
}create_and_fill
One call: create a pre-filled gift pack (same as create_pack). Returns ownerUrl + shopUrl + editToken. marketplace=amazon.com gives amazon.com /dp/ links; optional (en-US → amazon.com, otherwise amazon.se).
{
"type": "object",
"required": [],
"properties": {
"goal": {
"enum": [
"run",
"lift",
"yoga"
],
"type": "string"
},
"level": {
"enum": [
"starter",
"building",
"serious"
],
"type": "string"
},
"locale": {
"type": "string",
"description": "Optional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE)."
},
"country": {
"type": "string",
"description": "Optional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted."
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"budgetBand": {
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
],
"type": "string"
},
"athleteName": {
"type": "string"
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
}
},
"marketplace": {
"type": "string",
"description": "Optional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se."
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
}add_item
Add a gear item to an existing pack. Requires id + editToken; marketplace/locale optional.
{
"type": "object",
"required": [
"id",
"editToken"
],
"properties": {
"id": {
"type": "string",
"description": "Pack id"
},
"url": {
"type": "string"
},
"asin": {
"type": "string"
},
"name": {
"type": "string"
},
"emoji": {
"type": "string"
},
"notes": {
"type": "string"
},
"title": {
"type": "string"
},
"locale": {
"type": "string",
"description": "Optional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE)."
},
"country": {
"type": "string",
"description": "Optional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted."
},
"editToken": {
"type": "string"
},
"marketplace": {
"type": "string",
"description": "Optional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se."
},
"searchKeywords": {
"type": "string"
}
}
}browse_catalog
List hand-picked catalog products with /dp/ buy links: marketplace=amazon.com → US catalog (amazon.com/dp/ASIN?tag=sw-fitness-20), amazon.se → Swedish catalog (tag sw-fitness-21). If marketplace is omitted, en-US → amazon.com, otherwise amazon.se. Filter by goal/level/budgetBand/q.
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string"
},
"goal": {
"enum": [
"run",
"lift",
"yoga"
],
"type": "string"
},
"level": {
"enum": [
"starter",
"building",
"serious"
],
"type": "string"
},
"limit": {
"type": "number"
},
"locale": {
"type": "string",
"description": "Optional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE)."
},
"country": {
"type": "string",
"description": "Optional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted."
},
"budgetBand": {
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
],
"type": "string"
},
"marketplace": {
"type": "string",
"description": "Optional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se."
}
}
}resolve_product
Resolve ASIN, Amazon URL, or keywords to a buy URL (buyUrl + trackingTag) on amazon.com, amazon.se or another storefront. marketplace optional (en-US → amazon.com, otherwise amazon.se).
{
"type": "object",
"required": [],
"properties": {
"url": {
"type": "string"
},
"asin": {
"type": "string"
},
"goal": {
"enum": [
"run",
"lift",
"yoga"
],
"type": "string"
},
"level": {
"enum": [
"starter",
"building",
"serious"
],
"type": "string"
},
"locale": {
"type": "string",
"description": "Optional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE)."
},
"country": {
"type": "string",
"description": "Optional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted."
},
"keywords": {
"type": "string"
},
"marketplace": {
"type": "string",
"description": "Optional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se."
}
}
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1130 ms
- 95th percentile latency
- 1130 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1130 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http fitness-starter-mcp https://fitness-starter.vercel.app/api/mcpCodex
codex mcp add fitness-starter-mcp --url https://fitness-starter.vercel.app/api/mcpCursor
{
"mcpServers": {
"fitness-starter-mcp": {
"url": "https://fitness-starter.vercel.app/api/mcp"
}
}
}Cline
{
"mcpServers": {
"fitness-starter-mcp": {
"type": "streamableHttp",
"url": "https://fitness-starter.vercel.app/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"fitness-starter-mcp": {
"type": "http",
"url": "https://fitness-starter.vercel.app/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http fitness-starter-mcp https://fitness-starter.vercel.app/api/mcpClaude Desktop
{
"mcpServers": {
"fitness-starter-mcp": {
"url": "https://fitness-starter.vercel.app/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"fitness-starter-mcp": {
"serverUrl": "https://fitness-starter.vercel.app/api/mcp"
}
}
}Let your agent find its tools
Find servers like Fitness Starter MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.