API Documentation

https://api.intromakerai.com/mcp

claude mcp add --transport http intromakerai https://api.intromakerai.com/mcp \
  --header "Authorization: Bearer sk_your_api_key_here"

{
  "mcpServers": {
    "intromakerai": {
      "type": "http",
      "url": "https://api.intromakerai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_api_key_here"
      }
    }
  }
}

{
  "introduction": "Hi, I'm Jane, a software engineer turned AI researcher based in San Francisco. I build open source NLP tools and speak at conferences like PyCon about making AI accessible to everyone. When I'm not coding, I'm probably doing something questionable at high altitude. Let's connect!",
  "intro": "Same as introduction (kept for backward compatibility)",
  "id": "a1b2c3d4e5f6g7h",
  "based_on": {
    "profile": true,
    "template": "linkedin-headline",
    "previous_introduction": null,
    "style_reference_count": 3
  }
}

curl -X POST https://api.intromakerai.com/api/v1/regenerate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "id": "abc123",
    "adjustment": "shorter",
    "instruction": "drop the emoji and keep the city",
    "save": true
  }'

{
  "introduction": "The rewritten text",
  "revised": "Same as introduction (kept for backward compatibility)",
  "id": "abc123",
  "saved": true
}

{
  "messages": [
    { "role": "user", "content": "I need a bio for my LinkedIn profile" },
    { "role": "assistant", "content": "Happy to help. What's your name?" },
    { "role": "user", "content": "Jane Smith, I'm an AI engineer in Barcelona" }
  ]
}

{
  "done": false,
  "reply": "What would you like the bio to highlight?",
  "messages": [ ... ]
}

{
  "done": true,
  "reply": "Here's your introduction 👇",
  "introduction": "The generated text",
  "inputData": { ... },
  "messages": [ ... ]
}

curl https://api.intromakerai.com/api/v1/introductions?page=1&limit=10 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "introductions": [
    {
      "id": "uuid",
      "title": "Jane Smith Introduction",
      "content": "Hi, I'm Jane, a software engineer...",
      "language": "English",
      "created_at": "2026-03-16T10:30:00Z",
      "source": "api"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "total_pages": 5
  }
}

curl https://api.intromakerai.com/api/v1/introductions/abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "abc123",
  "title": "Jane Smith Introduction",
  "content": "The introduction text",
  "language": "English",
  "created_at": "2026-07-30T09:21:00.000Z",
  "source": "api"
}

curl -X POST https://api.intromakerai.com/api/v1/introductions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "title": "Conference bio",
    "content": "I'"'"'m Jane, an AI engineer based in Barcelona."
  }'

curl -X PATCH https://api.intromakerai.com/api/v1/introductions/abc123 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "content": "Hey there! I'\''m Celia, based in Taipei..." }'

{
  "id": "abc123",
  "title": "Celia Introduction",
  "content": "Hey there! I'm Celia, based in Taipei...",
  "language": "English",
  "source": "web"
}

curl -X DELETE https://api.intromakerai.com/api/v1/introductions/abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "id": "abc123"
}

curl https://api.intromakerai.com/api/v1/intro-options \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "profile": {
    "has_info": true,
    "name": "Jane Smith",
    "location": "San Francisco",
    "current_field": "AI & Machine Learning",
    "tone": "Professional",
    "language": "English"
  },
  "previous_introductions": [
    {
      "id": "a1b2c3d4e5f6g7h",
      "title": "Jane Smith - LinkedIn headline",
      "language": "English",
      "created_at": "2026-07-30 09:41:34.735Z",
      "source": "api",
      "preview": "Software engineer turned AI researcher | Open source NLP…"
    }
  ],
  "templates": [
    { "id": "linkedin-headline", "name": "LinkedIn Headline", "description": "Short professional tagline for a LinkedIn profile" }
  ],
  "usage": { "used": 4, "limit": 50, "remaining": 46, "plan": "paid" }
}

curl https://api.intromakerai.com/api/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "used": 3,
  "limit": 50,
  "remaining": 47,
  "renews_at": "2026-08-14T09:21:00.000Z",
  "plan": "paid"
}

curl -X POST https://api.intromakerai.com/api/v1/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "inputData": {
      "type": "Bio",
      "language": "English",
      "name": "Jane Smith",
      "location": "San Francisco",
      "background": { "fields": "Software engineer with 5 years of experience" },
      "current_field": "AI & Machine Learning",
      "projects": "Open source NLP tools",
      "passion": "Making AI accessible to everyone",
      "achievements": "Speaker at PyCon, 10k GitHub stars",
      "fun_fact": "I once debugged code while skydiving",
      "tone": "Professional",
      "must_include": "Who I am, the name of my business, who I help, how long I have been in business",
      "types": {
        "Name": "LinkedIn",
        "Purpose of the introduction": "Make recruiters and peers stop, read, and connect with me",
        "Audience": "LinkedIn visitors (recruiters, peers, potential collaborators)",
        "Maximum length?": "Custom (220 characters)",
        "Describe where are you going to use it": "LinkedIn profile headline",
        "CTA": "Let\'s connect!"
      }
    }
  }'

const response = await fetch(
  "https://api.intromakerai.com/api/v1/generate",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_API_KEY",
    },
    body: JSON.stringify({
      inputData: {
        type: "Bio",
        language: "English",
        name: "Jane Smith",
        location: "San Francisco",
        background: { fields: "Software engineer with 5 years of experience" },
        current_field: "AI & Machine Learning",
        projects: "Open source NLP tools",
        passion: "Making AI accessible to everyone",
        achievements: "Speaker at PyCon, 10k GitHub stars",
        fun_fact: "I once debugged code while skydiving",
        tone: "Professional",
        must_include: "Who I am, the name of my business, who I help, how long I have been in business",
        types: {
          "Name": "LinkedIn",
          "Purpose of the introduction": "Make recruiters and peers stop, read, and connect with me",
          "Audience": "LinkedIn visitors (recruiters, peers, potential collaborators)",
          "Maximum length?": "Custom (220 characters)",
          "Describe where are you going to use it": "LinkedIn profile headline",
          "CTA": "Let's connect!",
        },
      },
    }),
  }
);

const data = await response.json();
console.log(data.introduction); // Your generated introduction

import requests

response = requests.post(
    "https://api.intromakerai.com/api/v1/generate",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY",
    },
    json={
        "inputData": {
            "type": "Bio",
            "language": "English",
            "name": "Jane Smith",
            "location": "San Francisco",
            "background": {"fields": "Software engineer with 5 years of experience"},
            "current_field": "AI & Machine Learning",
            "projects": "Open source NLP tools",
            "passion": "Making AI accessible to everyone",
            "achievements": "Speaker at PyCon, 10k GitHub stars",
            "fun_fact": "I once debugged code while skydiving",
            "tone": "Professional",
            "must_include": "Who I am, the name of my business, who I help, how long I have been in business",
            "types": {
                "Name": "LinkedIn",
                "Purpose of the introduction": "Make recruiters and peers stop, read, and connect with me",
                "Audience": "LinkedIn visitors (recruiters, peers, potential collaborators)",
                "Maximum length?": "Custom (220 characters)",
                "Describe where are you going to use it": "LinkedIn profile headline",
                "CTA": "Let's connect!",
            },
        }
    },
)

data = response.json()
print(data["introduction"])  # Your generated introduction