# Datagma — how to use (mcp.ai)

Connect your Datagma account and use 8 tools for analytics straight from your AI agent. Connect with your own API key. Datagma delivers data intelligence and analytics, assisting companies in discovering market insights, tracking competitive metrics, and strategizing growth opportunities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_datagma?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `datagma_detect_job_change`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/datagma`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/datagma/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/datagma/detect/job/change` — Tool to detect if a contact changed jobs. Use when verifying a contact’s current employment details by email.
  - body: { email: string }
- `POST https://api.mcp.ai/api/datagma/enrich/person/or/company` — Enrich person or company data using LinkedIn URLs, emails, domains, or names. Returns enriched data including: contact information, LinkedIn profiles, company details, work experience, education, phon
  - body: { data: string, debug?: boolean, fullName?: string, lastName?: string, firstName?: string, phoneFull?: boolean, personFull?: boolean, companyFull?: boolean, countryCode?: string, deepTraffic?: boolean, companyFrench?: boolean, whatsappCheck?: boolean, companyKeyword?: string, companyPremium?: boolean }
- `POST https://api.mcp.ai/api/datagma/find/work/email` — Find verified work email address for a person using their name and company. Returns a professionally verified email address with validation metadata including SMTP checks and MX records. Requires eith
  - body: { company?: string, fullName?: string, lastName?: string, firstName?: string, linkedInSlug?: string }
- `POST https://api.mcp.ai/api/datagma/get/credits` — Get the current credit balance for the authenticated Datagma API account. Use this to check how many API credits remain before making enrichment calls.
  - body: { email?: string }
- `POST https://api.mcp.ai/api/datagma/get/twitter/by/email` — Retrieve Twitter account information associated with an email address. This action looks up Twitter username and display name for a given email address using Datagma's enrichment database. Returns Twi
  - body: { email: string }
- `POST https://api.mcp.ai/api/datagma/get/twitter/by/username` — Enrich Twitter profile data using Datagma's database. Returns contact information (email), social media profiles (LinkedIn, Facebook, GitHub), and professional details (skills, interests, industry) as
  - body: { username: string }
- `POST https://api.mcp.ai/api/datagma/reverse/phone/lookup` — Tool to reverse-lookup information associated with a phone number. Use when you have a phone number and need associated details (e.g., carrier, location).
  - body: { phone: string }
- `POST https://api.mcp.ai/api/datagma/search/phone/numbers` — Find mobile phone numbers using email address and/or LinkedIn profile URL. Returns list of phone numbers with confidence scores and optional WhatsApp verification. Best results when both email and Lin
  - body: { apiId?: string, email?: string, username?: string, minimumMatch?: integer, whatsappCheck?: boolean }

## Example prompts
- "What can I do in Datagma?"
- "Show me a summary of my Datagma account"

## More
- Page: https://mcp.ai/datagma
- Agent spec (llms.txt): https://mcp.ai/datagma/llms.txt
- Postman collection: https://mcp.ai/datagma/postman.json