For assistants and developers

Photo decisions you can explain.

Gravitate MCP connects assistants to our public photo methodology, practical shoot plans and deterministic score calculator. It is designed for adults choosing dating-profile photos, including single fathers and people returning to dating.

Free now: all six tools — photo guidance, dating guides, fictional profile examples, shoot plans, calculations from supplied observations and service status. No account, payment or Gravitate credits required. Your assistant provider’s own subscription or API fees are separate. Image uploads, hosted image analysis, image generation and purchases remain paused.

Connect

Endpoint: https://joingravitate.com/mcp
Transport: Streamable HTTP. No account, API key or payment required.

codex mcp add gravitate --url https://joingravitate.com/mcp

claude mcp add --transport http --scope user gravitate https://joingravitate.com/mcp

For other compatible clients, add the endpoint as a remote MCP server. Restart or reconnect the client to load its tools.

Six free tools

• get_photo_guidance: retrieve the published method, example, presentation guidance, image principles or integration documentation. Topics are fixed; responses include their canonical source.
• build_photo_shoot_plan: create a 15, 30 or 60 minute plan using a stated context, setting and photographer.
• score_photo_observations: calculate gravitate-v1 totals for up to six sets of supplied ranks. Accepts only labels A–F, numeric ranks and usability flags.
• get_dating_guide: browse the catalog or retrieve a published guide about single dads, dating again or reflecting on an ex. Canonical citations and update dates included.
• get_profile_example: read an annotated, fictional bio and photo lineup for a single dad or someone returning to dating. Not a customer outcome, personalized assessment or image analysis.
• get_service_status: check availability, limits and paused capabilities before suggesting a workflow.

All tools accept locale: "en" or locale: "fr". The service also exposes 36 public resources: 12 photo references and 24 localized coaching articles.

Try these requests

• “I’m a single dad with 30 minutes and a phone timer. Help me plan my dating photos.”
• “Explain how Gravitate scores photo presentation and what the score cannot tell me.”
• « Je reprends les rencontres et j’ai quinze minutes. Quelles photos puis-je préparer chez moi ? »

Scoring without sending images

Read the methodology first. A human or the calling assistant can supply observations; Gravitate only calculates. Illustrative observations must remain labelled as illustrative. Never invent ranks for an unseen image.

{"locale":"en","observation_source":"illustrative","photos":[
  {"label":"A","ranks":{"craft":3,"face":4,"pose":3,"setting":3,"signal":2},
   "subject_present":true,"visual_defect":false}
]}

These assigned ranks produce 75/100: 5 × (3 + 4 + 3 + 3 + 2). This is not an analysis of an uploaded image. Scores concern presentation, not inherent beauty, attraction percentiles or likely matches. A strong clear portrait may lead ahead of an activity photo with a higher total.

Limits and data

Up to 60 HTTP requests per minute per client IP, 64 KiB per request and six observations per calculation. A 429 response includes Retry-After. Requests above the size limit return 413. Images, image URLs and unrecognized input fields are rejected. No AI provider is called and no profile database is connected.

The source repository is private. Public server metadata describes the supported remote connection. See privacy and support.