English Français العربية

Paceva

السجل الرسمي الصحة

Your swim, bike and run training: readiness, HRV, sleep, workouts and race predictions. Read-only.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http paceva 'https://paceva.app/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "paceva": {
            "type": "http",
            "url": "https://paceva.app/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Paceva for developers
  2. Connect in one minute
  3. What's here
  4. Ground rules
  5. Status
  6. Security
  7. License

Paceva for developers

Paceva turns an endurance athlete's watch data into honest race predictions: ranges, checked against their own history. This repository documents the public surface: the Paceva MCP server, the OAuth 2.1 sign-in in front of it, and how Paceva connects to Intervals.icu.

The Paceva app itself is closed source. This repo is documentation and examples only.

Connect in one minute

Server URL: https://paceva.app/api/mcp

AppHow
Claude (claude.ai, desktop, mobile)Settings → Connectors → Add custom connector, paste the URL, sign in to Paceva, approve.
ChatGPTSettings → Apps & Connectors → add a custom connector with the URL (some plans need developer mode).
Claude Codeclaude mcp add --transport http paceva https://paceva.app/api/mcp, then /mcp to sign in.
Cursor / VS CodeOne-click buttons on paceva.app/dashboard/ai, or add it as a Streamable HTTP server.
Anything elseAny MCP client that supports Streamable HTTP and OAuth 2.1 with PKCE.

Then ask things like "Should I go hard today?", "What could I swim a 1500 in right now?" or "How did my last block of riding go?".

Full walkthrough: docs/connect.md.

What's here

DocFor
docs/connect.mdConnecting each AI app, and what to expect
docs/tools.mdEvery MCP tool, its arguments and what it returns
docs/oauth.mdThe OAuth 2.1 server: discovery, PKCE, client registration, tokens
docs/intervals-icu.mdHow watch data gets in: the Intervals.icu sign-in, step by step
docs/data-and-privacy.mdWhat the AI app can and can't see
docs/listing.mdThe MCP Registry entry (server.json) and directories to submit to
examples/curl discovery, a raw JSON-RPC call, client config snippets

Ground rules

  • Read-only. One scope, paceva:read. No tool writes anything.
  • Only your own data. A token is bound to one Paceva account; it can never read anyone else's.
  • Every number is labelled. device values are your watch's own (e.g. Garmin's HRV); paceva values are computed by Paceva.
  • Predictions are ranges. Tools return a low–high range and how often that range holds for you. Quote the range, not a single time.
  • Revocable. Disconnect any app from Paceva → Use with AI; its tokens stop working on the next call.

Status

PieceStatus
MCP server + OAuthLive
Intervals.icu sync (Garmin, Coros, Wahoo, Polar, Suunto)Live
Paceva web dashboardComing soon, join the waitlist
iPhone app (Apple Health)Coming soon

Security

Found a problem? Please email privacy@paceva.app rather than opening a public issue. See SECURITY.md.

License

Docs and examples in this repository are MIT licensed. The Paceva name and logo are not.

الأسئلة الشائعة

ما هو Paceva؟

Your swim, bike and run training: readiness, HRV, sleep, workouts and race predictions. Read-only.

كيف أثبّت Paceva؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http paceva 'https://paceva.app/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Paceva إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Paceva مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Paceva؟

ينشره OwenScheuer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.