For the complete documentation index, see llms.txt.

Meta Tag Generator API

webmaster 1 credit / call v2026-04-22

Build SEO, Open Graph, and Twitter Card meta tags with inherited defaults, length checks, and Google, Facebook, and Twitter preview data.

One POST adds Meta Tag Generator to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled.

prefer a UI? Open the Meta Tag Generator on miniwebtool.com →

Start free — get a key → 1,000 credits · no card · 30 seconds

Endpoint

POST · 1cr
POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/run

Request body

Field Type Req.
title
page title
str
description
meta description
str
keywords
comma-separated keywords
str
author
author name
str
robots
index, follow | noindex, follow | index, nofollow | noindex, nofollow
str
canonical
canonical URL
str
viewport
viewport content
str
charset
document charset
str
language
content language
str
og_title
og:title, defaults to title
str
og_description
og:description, defaults to description
str
og_type
website | article | product | profile | video.other
str
og_url
og:url, defaults to canonical
str
og_image
og:image URL
str
og_site_name
og:site_name
str
og_locale
og:locale
str
twitter_card
summary_large_image | summary | app | player
str
twitter_site
twitter:site handle
str
twitter_creator
twitter:creator handle
str
twitter_title
twitter:title, defaults to og:title
str
twitter_description
twitter:description, defaults to og:description
str
twitter_image
twitter:image, defaults to og:image
str

Cost & access

  • 1 credit per successful call — failed calls refund.
  • Starts on: Free.
  • Max payload: 262144 bytes.
  • Privacy mode: no_body_logs
  • Available on: free, starter, pro, business, scale

Response envelope

{
  "request_id": "01K...",
  "tool": "meta-tag-generator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": { ... }
}

Try it

Stored only in this browser tab. Playground test key is prefilled and only works on this page. Get a live key →
page title
meta description
comma-separated keywords
author name
index, follow | noindex, follow | index, nofollow | noindex, nofollow
canonical URL
viewport content
document charset
content language
og:title, defaults to title
og:description, defaults to description
website | article | product | profile | video.other
og:url, defaults to canonical
og:image URL
og:site_name
og:locale
summary_large_image | summary | app | player
twitter:site handle
twitter:creator handle
twitter:title, defaults to og:title
twitter:description, defaults to og:description
twitter:image, defaults to og:image

Get your own key

1,000 free calls/mo · no card · key arrives by email

One verification click, then your key + a ready-to-run request. No card, no spam.

Code examples

curl -X POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Miniwebtool - Free Online Tools","description":"Free online calculators and converters.","canonical":"https://example.com/"}'
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/meta-tag-generator/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={'title': 'Miniwebtool - Free Online Tools', 'description': 'Free online calculators and converters.', 'canonical': 'https://example.com/'},
)
resp.raise_for_status()
data = resp.json()
print(data)
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/meta-tag-generator/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({"title":"Miniwebtool - Free Online Tools","description":"Free online calculators and converters.","canonical":"https://example.com/"}),
  }
);
const data = await resp.json();
console.log(data);
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/meta-tag-generator/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Miniwebtool - Free Online Tools',
    'description' => 'Free online calculators and converters.',
    'canonical' => 'https://example.com/'
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/meta-tag-generator/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {
  'title' => 'Miniwebtool - Free Online Tools',
  'description' => 'Free online calculators and converters.',
  'canonical' => 'https://example.com/'
}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[string]interface{}{
    "title": "Miniwebtool - Free Online Tools",
    "description": "Free online calculators and converters.",
    "canonical": "https://example.com/",
  })
  req, _ := http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/meta-tag-generator/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  out, _ := io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miniwebtool.com/v1/tools/meta-tag-generator/run"))
    .header("Authorization", "Bearer mwt_live_YOUR_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"title\":\"Miniwebtool - Free Online Tools\",\"description\":\"Free online calculators and converters.\",\"canonical\":\"https://example.com/\"}"))
    .build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
agents let your coding agent do it

Copy this into Claude Code, Cursor, Codex, Aider or Cline. It carries the endpoint, the full schema, a sample response, and the credit rules — so the agent wires meta-tag-generator up correctly without draining your key.

Free to iterate: the prompt points the agent at POST /v1/tools/meta-tag-generator/dry-run, which validates the request and returns the response shape for 0 credits. Only the final confirmation call is billed (1 credit).
Stable URL for this prompt: /tools/meta-tag-generator/prompt.md (?variant=cursor / ?variant=mcp).
Paste into Claude Code, or save as CLAUDE.md context.
Integrate the MiniWebtool Meta Tag Generator API into this project.

## Your task

1. Read the reference below.
2. Ask me where this belongs in the codebase if it is not obvious.
3. Write the integration in the language and style of the surrounding code:
   a small typed client function, errors handled, key read from the
   environment (never hard-coded, never committed).
4. Verify with `/dry-run` first, then exactly one live call.
5. Show me the diff and the live result.

## Credit budget — follow these exactly

This API is metered. A live call costs 1 credit; the free tier
includes 1,000 credits per month. Burning them during integration is the
single most common way to waste this key.

1. **Do all wiring against `/dry-run`, which costs 0 credits.** It validates the
   payload for real and returns a sample result with the exact response shape.
   Iterate there until your request builds and your parsing works.
2. **Make at most ONE live `/run` call** — a single end-to-end confirmation once
   dry-run passes. Print the result, then stop.
3. **Never call the API from unit tests, examples, or a retry loop.** Assert
   against the sample response captured from `/dry-run` instead.
4. **On 4xx, fix the payload — do not retry.** The error body is RFC 7807
   `application/problem+json` and says exactly what is wrong.
5. **On 429, honour `Retry-After`** and back off; do not tighten the loop.
6. **Read `X-MWT-Credits-Remaining`** on every response. If it drops below 50,
   stop making live calls and tell me.
7. If the integration needs repeated calls at runtime, **cache by input** — this
   tool is deterministic, so the same input always returns the same output.

## The API

**Meta Tag Generator** — Build SEO, Open Graph, and Twitter Card meta tags with inherited defaults, length checks, and Google, Facebook, and Twitter preview data.

- Live endpoint: `POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/run` — costs 1 credit
- Dry run: `POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/dry-run` — costs 0 credits, same auth and validation
- Auth: `Authorization: Bearer <MINIWEBTOOL_API_KEY>`
- Content type: `application/json`
- Tool version: `2026-04-22` (output shape is stable within a major version)
- Full machine-readable spec: `https://api.miniwebtool.com/v1/openapi.json`

### Request body

| field | type | required | notes |
|---|---|---|---|
| `title` | str | no | page title (default `Miniwebtool - Free Online Tools`) |
| `description` | str | no | meta description (default `A large collection of free online calculators and converters for maths, finance, health, and text.`) |
| `keywords` | str | no | comma-separated keywords (default `calculator, converter, online tools`) |
| `author` | str | no | author name |
| `robots` | str | no | one of: index, follow, noindex, follow, index, nofollow, noindex, nofollow — index, follow \| noindex, follow \| index, nofollow \| noindex, nofollow (default `index, follow`) |
| `canonical` | str | no | canonical URL (default `https://example.com/`) |
| `viewport` | str | no | viewport content (default `width=device-width, initial-scale=1`) |
| `charset` | str | no | document charset (default `UTF-8`) |
| `language` | str | no | content language (default `en`) |
| `og_title` | str | no | og:title, defaults to title |
| `og_description` | str | no | og:description, defaults to description |
| `og_type` | str | no | one of: website, article, product, profile, video.other — website \| article \| product \| profile \| video.other (default `website`) |
| `og_url` | str | no | og:url, defaults to canonical |
| `og_image` | str | no | og:image URL |
| `og_site_name` | str | no | og:site_name |
| `og_locale` | str | no | og:locale (default `en_US`) |
| `twitter_card` | str | no | one of: summary_large_image, summary, app, player — summary_large_image \| summary \| app \| player (default `summary_large_image`) |
| `twitter_site` | str | no | twitter:site handle |
| `twitter_creator` | str | no | twitter:creator handle |
| `twitter_title` | str | no | twitter:title, defaults to og:title |
| `twitter_description` | str | no | twitter:description, defaults to og:description |
| `twitter_image` | str | no | twitter:image, defaults to og:image |

Example request body:

```json
{
  "title": "Miniwebtool - Free Online Tools",
  "description": "Free online calculators and converters.",
  "canonical": "https://example.com/"
}
```

### Response envelope

```json
{
  "request_id": "req_01H…",
  "tool": "meta-tag-generator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {
    "html": "<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Miniwebtool - Free Online Tools</title>\n<meta name=\"description\" content=\"Free online calculators and converters.\">\n<meta name=\"keywords\" content=\"calculator, converter, online tools\">\n<meta name=\"robots\" content=\"index, follow\">\n<meta name=\"language\" content=\"en\">\n<link rel=\"canonical\" href=\"https://example.com/\">\n\n<meta property=\"og:title\" content=\"Miniwebtool - Free Online Tools\">\n<meta property=\"og:type\" content=\"website\">\n<meta property=\"og:description\" content=\"Free online calculators and converters.\">\n<meta property=\"og:url\" content=\"https://example.com/\">\n<meta property=\"og:locale\" content=\"en_US\">\n\n<meta name=\"twitter:card\" content=\"summary_large_image\">\n<meta name=\"twitter:title\" content=\"Miniwebtool - Free Online Tools\">\n<meta name=\"twitter:description\" content=\"Free online calculators and converters.\">",
    "seo_tags": [
      "<meta charset=\"UTF-8\">",
      "<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">",
      "<title>Miniwebtool - Free Online Tools</title>",
      "<meta name=\"description\" content=\"Free online calculators and converters.\">",
      "<meta name=\"keywords\" content=\"calculator, converter, online tools\">",
      "<meta name=\"robots\" content=\"index, follow\">",
      "<meta name=\"language\" content=\"en\">",
      "<link rel=\"canonical\" href=\"https://example.com/\">"
    ],
    "open_graph_tags": [
      "<meta property=\"og:title\" content=\"Miniwebtool - Free Online Tools\">",
      "<meta property=\"og:type\" content=\"website\">",
      "<meta property=\"og:description\" content=\"Free online calculators and converters.\">",
      "<meta property=\"og:url\" content=\"https://example.com/\">",
      "<meta property=\"og:locale\" content=\"en_US\">"
    ],
    "twitter_tags": [
      "<meta name=\"twitter:card\" content=\"summary_large_image\">",
      "<meta name=\"twitter:title\" content=\"Miniwebtool - Free Online Tools\">",
      "<meta name=\"twitter:description\" content=\"Free online calculators and converters.\">"
    ],
    "tag_count": 16,
    "output_bytes": 924,
    "title_length": 31,
    "description_length": 39,
    "checks": [
      {
        "check": "title_length",
        "passed": true,
        "message": "title is 31 characters (ideal 30-60)"
      },
      {
        "check": "description_length",
        "passed": false,
        "message": "description is 39 characters (ideal 70-160)"
      },
      {
        "check": "canonical_present",
        "passed": true,
        "message": "canonical URL set"
      },
      {
        "check": "og_image_present",
        "passed": false,
        "message": "og:image missing"
      },
      {
        "check": "twitter_image_present",
        "passed": false,
        "message": "twitter:image missing"
      },
      {
        "check": "og_title_length",
        "passed": true,
        "message": "og:title is 31 characters (max 88)"
      }
    ],
    "checks_passed": 3,
    "checks_total": 6,
    "previews": {
      "google": {
        "title": "Miniwebtool - Free Online Tools",
        "url": "https://example.com/",
        "description": "Free online calculators and converters."
      },
      "facebook": {
        "title": "Miniwebtool - Free Online Tools",
        "description": "Free online calculators and converters.",
        "image": "",
        "site_name": ""
      },
      "twitter": {
        "card": "summary_large_image",
        "title": "Miniwebtool - Free Online Tools",
        "description": "Free online calculators and converters.",
        "image": ""
      }
    }
  }
}
```

`result` holds the tool output. Errors come back as
`application/problem+json` with `type`, `title`, `status`, and `detail`.

### Getting a key

If `MINIWEBTOOL_API_KEY` is not already in the environment, stop and ask me for
one — do not sign up, scrape, or guess a key. Free keys: https://api.miniwebtool.com/dashboard/
Paste into Codex, Aider, Cline, or any coding agent.
Integrate the MiniWebtool Meta Tag Generator API into this project.

## Your task

1. Read the reference below.
2. Ask me where this belongs in the codebase if it is not obvious.
3. Write the integration in the language and style of the surrounding code:
   a small typed client function, errors handled, key read from the
   environment (never hard-coded, never committed).
4. Verify with `/dry-run` first, then exactly one live call.
5. Show me the diff and the live result.

## Credit budget — follow these exactly

This API is metered. A live call costs 1 credit; the free tier
includes 1,000 credits per month. Burning them during integration is the
single most common way to waste this key.

1. **Do all wiring against `/dry-run`, which costs 0 credits.** It validates the
   payload for real and returns a sample result with the exact response shape.
   Iterate there until your request builds and your parsing works.
2. **Make at most ONE live `/run` call** — a single end-to-end confirmation once
   dry-run passes. Print the result, then stop.
3. **Never call the API from unit tests, examples, or a retry loop.** Assert
   against the sample response captured from `/dry-run` instead.
4. **On 4xx, fix the payload — do not retry.** The error body is RFC 7807
   `application/problem+json` and says exactly what is wrong.
5. **On 429, honour `Retry-After`** and back off; do not tighten the loop.
6. **Read `X-MWT-Credits-Remaining`** on every response. If it drops below 50,
   stop making live calls and tell me.
7. If the integration needs repeated calls at runtime, **cache by input** — this
   tool is deterministic, so the same input always returns the same output.

## The API

**Meta Tag Generator** — Build SEO, Open Graph, and Twitter Card meta tags with inherited defaults, length checks, and Google, Facebook, and Twitter preview data.

- Live endpoint: `POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/run` — costs 1 credit
- Dry run: `POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/dry-run` — costs 0 credits, same auth and validation
- Auth: `Authorization: Bearer <MINIWEBTOOL_API_KEY>`
- Content type: `application/json`
- Tool version: `2026-04-22` (output shape is stable within a major version)
- Full machine-readable spec: `https://api.miniwebtool.com/v1/openapi.json`

### Request body

| field | type | required | notes |
|---|---|---|---|
| `title` | str | no | page title (default `Miniwebtool - Free Online Tools`) |
| `description` | str | no | meta description (default `A large collection of free online calculators and converters for maths, finance, health, and text.`) |
| `keywords` | str | no | comma-separated keywords (default `calculator, converter, online tools`) |
| `author` | str | no | author name |
| `robots` | str | no | one of: index, follow, noindex, follow, index, nofollow, noindex, nofollow — index, follow \| noindex, follow \| index, nofollow \| noindex, nofollow (default `index, follow`) |
| `canonical` | str | no | canonical URL (default `https://example.com/`) |
| `viewport` | str | no | viewport content (default `width=device-width, initial-scale=1`) |
| `charset` | str | no | document charset (default `UTF-8`) |
| `language` | str | no | content language (default `en`) |
| `og_title` | str | no | og:title, defaults to title |
| `og_description` | str | no | og:description, defaults to description |
| `og_type` | str | no | one of: website, article, product, profile, video.other — website \| article \| product \| profile \| video.other (default `website`) |
| `og_url` | str | no | og:url, defaults to canonical |
| `og_image` | str | no | og:image URL |
| `og_site_name` | str | no | og:site_name |
| `og_locale` | str | no | og:locale (default `en_US`) |
| `twitter_card` | str | no | one of: summary_large_image, summary, app, player — summary_large_image \| summary \| app \| player (default `summary_large_image`) |
| `twitter_site` | str | no | twitter:site handle |
| `twitter_creator` | str | no | twitter:creator handle |
| `twitter_title` | str | no | twitter:title, defaults to og:title |
| `twitter_description` | str | no | twitter:description, defaults to og:description |
| `twitter_image` | str | no | twitter:image, defaults to og:image |

Example request body:

```json
{
  "title": "Miniwebtool - Free Online Tools",
  "description": "Free online calculators and converters.",
  "canonical": "https://example.com/"
}
```

### Response envelope

```json
{
  "request_id": "req_01H…",
  "tool": "meta-tag-generator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {
    "html": "<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Miniwebtool - Free Online Tools</title>\n<meta name=\"description\" content=\"Free online calculators and converters.\">\n<meta name=\"keywords\" content=\"calculator, converter, online tools\">\n<meta name=\"robots\" content=\"index, follow\">\n<meta name=\"language\" content=\"en\">\n<link rel=\"canonical\" href=\"https://example.com/\">\n\n<meta property=\"og:title\" content=\"Miniwebtool - Free Online Tools\">\n<meta property=\"og:type\" content=\"website\">\n<meta property=\"og:description\" content=\"Free online calculators and converters.\">\n<meta property=\"og:url\" content=\"https://example.com/\">\n<meta property=\"og:locale\" content=\"en_US\">\n\n<meta name=\"twitter:card\" content=\"summary_large_image\">\n<meta name=\"twitter:title\" content=\"Miniwebtool - Free Online Tools\">\n<meta name=\"twitter:description\" content=\"Free online calculators and converters.\">",
    "seo_tags": [
      "<meta charset=\"UTF-8\">",
      "<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">",
      "<title>Miniwebtool - Free Online Tools</title>",
      "<meta name=\"description\" content=\"Free online calculators and converters.\">",
      "<meta name=\"keywords\" content=\"calculator, converter, online tools\">",
      "<meta name=\"robots\" content=\"index, follow\">",
      "<meta name=\"language\" content=\"en\">",
      "<link rel=\"canonical\" href=\"https://example.com/\">"
    ],
    "open_graph_tags": [
      "<meta property=\"og:title\" content=\"Miniwebtool - Free Online Tools\">",
      "<meta property=\"og:type\" content=\"website\">",
      "<meta property=\"og:description\" content=\"Free online calculators and converters.\">",
      "<meta property=\"og:url\" content=\"https://example.com/\">",
      "<meta property=\"og:locale\" content=\"en_US\">"
    ],
    "twitter_tags": [
      "<meta name=\"twitter:card\" content=\"summary_large_image\">",
      "<meta name=\"twitter:title\" content=\"Miniwebtool - Free Online Tools\">",
      "<meta name=\"twitter:description\" content=\"Free online calculators and converters.\">"
    ],
    "tag_count": 16,
    "output_bytes": 924,
    "title_length": 31,
    "description_length": 39,
    "checks": [
      {
        "check": "title_length",
        "passed": true,
        "message": "title is 31 characters (ideal 30-60)"
      },
      {
        "check": "description_length",
        "passed": false,
        "message": "description is 39 characters (ideal 70-160)"
      },
      {
        "check": "canonical_present",
        "passed": true,
        "message": "canonical URL set"
      },
      {
        "check": "og_image_present",
        "passed": false,
        "message": "og:image missing"
      },
      {
        "check": "twitter_image_present",
        "passed": false,
        "message": "twitter:image missing"
      },
      {
        "check": "og_title_length",
        "passed": true,
        "message": "og:title is 31 characters (max 88)"
      }
    ],
    "checks_passed": 3,
    "checks_total": 6,
    "previews": {
      "google": {
        "title": "Miniwebtool - Free Online Tools",
        "url": "https://example.com/",
        "description": "Free online calculators and converters."
      },
      "facebook": {
        "title": "Miniwebtool - Free Online Tools",
        "description": "Free online calculators and converters.",
        "image": "",
        "site_name": ""
      },
      "twitter": {
        "card": "summary_large_image",
        "title": "Miniwebtool - Free Online Tools",
        "description": "Free online calculators and converters.",
        "image": ""
      }
    }
  }
}
```

`result` holds the tool output. Errors come back as
`application/problem+json` with `type`, `title`, `status`, and `detail`.

### Getting a key

If `MINIWEBTOOL_API_KEY` is not already in the environment, stop and ask me for
one — do not sign up, scrape, or guess a key. Free keys: https://api.miniwebtool.com/dashboard/
Save as .cursor/rules/miniwebtool-meta-tag-generator.mdc
---
description: MiniWebtool Meta Tag Generator API — usage and credit budget
globs:
alwaysApply: false
---

# MiniWebtool Meta Tag Generator API

## The API

**Meta Tag Generator** — Build SEO, Open Graph, and Twitter Card meta tags with inherited defaults, length checks, and Google, Facebook, and Twitter preview data.

- Live endpoint: `POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/run` — costs 1 credit
- Dry run: `POST https://api.miniwebtool.com/v1/tools/meta-tag-generator/dry-run` — costs 0 credits, same auth and validation
- Auth: `Authorization: Bearer <MINIWEBTOOL_API_KEY>`
- Content type: `application/json`
- Tool version: `2026-04-22` (output shape is stable within a major version)
- Full machine-readable spec: `https://api.miniwebtool.com/v1/openapi.json`

### Request body

| field | type | required | notes |
|---|---|---|---|
| `title` | str | no | page title (default `Miniwebtool - Free Online Tools`) |
| `description` | str | no | meta description (default `A large collection of free online calculators and converters for maths, finance, health, and text.`) |
| `keywords` | str | no | comma-separated keywords (default `calculator, converter, online tools`) |
| `author` | str | no | author name |
| `robots` | str | no | one of: index, follow, noindex, follow, index, nofollow, noindex, nofollow — index, follow \| noindex, follow \| index, nofollow \| noindex, nofollow (default `index, follow`) |
| `canonical` | str | no | canonical URL (default `https://example.com/`) |
| `viewport` | str | no | viewport content (default `width=device-width, initial-scale=1`) |
| `charset` | str | no | document charset (default `UTF-8`) |
| `language` | str | no | content language (default `en`) |
| `og_title` | str | no | og:title, defaults to title |
| `og_description` | str | no | og:description, defaults to description |
| `og_type` | str | no | one of: website, article, product, profile, video.other — website \| article \| product \| profile \| video.other (default `website`) |
| `og_url` | str | no | og:url, defaults to canonical |
| `og_image` | str | no | og:image URL |
| `og_site_name` | str | no | og:site_name |
| `og_locale` | str | no | og:locale (default `en_US`) |
| `twitter_card` | str | no | one of: summary_large_image, summary, app, player — summary_large_image \| summary \| app \| player (default `summary_large_image`) |
| `twitter_site` | str | no | twitter:site handle |
| `twitter_creator` | str | no | twitter:creator handle |
| `twitter_title` | str | no | twitter:title, defaults to og:title |
| `twitter_description` | str | no | twitter:description, defaults to og:description |
| `twitter_image` | str | no | twitter:image, defaults to og:image |

Example request body:

```json
{
  "title": "Miniwebtool - Free Online Tools",
  "description": "Free online calculators and converters.",
  "canonical": "https://example.com/"
}
```

### Response envelope

```json
{
  "request_id": "req_01H…",
  "tool": "meta-tag-generator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {
    "html": "<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Miniwebtool - Free Online Tools</title>\n<meta name=\"description\" content=\"Free online calculators and converters.\">\n<meta name=\"keywords\" content=\"calculator, converter, online tools\">\n<meta name=\"robots\" content=\"index, follow\">\n<meta name=\"language\" content=\"en\">\n<link rel=\"canonical\" href=\"https://example.com/\">\n\n<meta property=\"og:title\" content=\"Miniwebtool - Free Online Tools\">\n<meta property=\"og:type\" content=\"website\">\n<meta property=\"og:description\" content=\"Free online calculators and converters.\">\n<meta property=\"og:url\" content=\"https://example.com/\">\n<meta property=\"og:locale\" content=\"en_US\">\n\n<meta name=\"twitter:card\" content=\"summary_large_image\">\n<meta name=\"twitter:title\" content=\"Miniwebtool - Free Online Tools\">\n<meta name=\"twitter:description\" content=\"Free online calculators and converters.\">",
    "seo_tags": [
      "<meta charset=\"UTF-8\">",
      "<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">",
      "<title>Miniwebtool - Free Online Tools</title>",
      "<meta name=\"description\" content=\"Free online calculators and converters.\">",
      "<meta name=\"keywords\" content=\"calculator, converter, online tools\">",
      "<meta name=\"robots\" content=\"index, follow\">",
      "<meta name=\"language\" content=\"en\">",
      "<link rel=\"canonical\" href=\"https://example.com/\">"
    ],
    "open_graph_tags": [
      "<meta property=\"og:title\" content=\"Miniwebtool - Free Online Tools\">",
      "<meta property=\"og:type\" content=\"website\">",
      "<meta property=\"og:description\" content=\"Free online calculators and converters.\">",
      "<meta property=\"og:url\" content=\"https://example.com/\">",
      "<meta property=\"og:locale\" content=\"en_US\">"
    ],
    "twitter_tags": [
      "<meta name=\"twitter:card\" content=\"summary_large_image\">",
      "<meta name=\"twitter:title\" content=\"Miniwebtool - Free Online Tools\">",
      "<meta name=\"twitter:description\" content=\"Free online calculators and converters.\">"
    ],
    "tag_count": 16,
    "output_bytes": 924,
    "title_length": 31,
    "description_length": 39,
    "checks": [
      {
        "check": "title_length",
        "passed": true,
        "message": "title is 31 characters (ideal 30-60)"
      },
      {
        "check": "description_length",
        "passed": false,
        "message": "description is 39 characters (ideal 70-160)"
      },
      {
        "check": "canonical_present",
        "passed": true,
        "message": "canonical URL set"
      },
      {
        "check": "og_image_present",
        "passed": false,
        "message": "og:image missing"
      },
      {
        "check": "twitter_image_present",
        "passed": false,
        "message": "twitter:image missing"
      },
      {
        "check": "og_title_length",
        "passed": true,
        "message": "og:title is 31 characters (max 88)"
      }
    ],
    "checks_passed": 3,
    "checks_total": 6,
    "previews": {
      "google": {
        "title": "Miniwebtool - Free Online Tools",
        "url": "https://example.com/",
        "description": "Free online calculators and converters."
      },
      "facebook": {
        "title": "Miniwebtool - Free Online Tools",
        "description": "Free online calculators and converters.",
        "image": "",
        "site_name": ""
      },
      "twitter": {
        "card": "summary_large_image",
        "title": "Miniwebtool - Free Online Tools",
        "description": "Free online calculators and converters.",
        "image": ""
      }
    }
  }
}
```

`result` holds the tool output. Errors come back as
`application/problem+json` with `type`, `title`, `status`, and `detail`.

### Getting a key

If `MINIWEBTOOL_API_KEY` is not already in the environment, stop and ask me for
one — do not sign up, scrape, or guess a key. Free keys: https://api.miniwebtool.com/dashboard/

## Credit budget — follow these exactly

This API is metered. A live call costs 1 credit; the free tier
includes 1,000 credits per month. Burning them during integration is the
single most common way to waste this key.

1. **Do all wiring against `/dry-run`, which costs 0 credits.** It validates the
   payload for real and returns a sample result with the exact response shape.
   Iterate there until your request builds and your parsing works.
2. **Make at most ONE live `/run` call** — a single end-to-end confirmation once
   dry-run passes. Print the result, then stop.
3. **Never call the API from unit tests, examples, or a retry loop.** Assert
   against the sample response captured from `/dry-run` instead.
4. **On 4xx, fix the payload — do not retry.** The error body is RFC 7807
   `application/problem+json` and says exactly what is wrong.
5. **On 429, honour `Retry-After`** and back off; do not tighten the loop.
6. **Read `X-MWT-Credits-Remaining`** on every response. If it drops below 50,
   stop making live calls and tell me.
7. If the integration needs repeated calls at runtime, **cache by input** — this
   tool is deterministic, so the same input always returns the same output.
Skip the HTTP client — connect the agent directly.
Add the MiniWebtool MCP server to this project, then use the
`meta-tag-generator` tool from it.

Server URL: https://api.miniwebtool.com/v1/mcp
Transport: HTTP (Streamable HTTP / JSON-RPC 2.0)
Auth header: `Authorization: Bearer <MINIWEBTOOL_API_KEY>`

Claude Code:

```bash
claude mcp add --transport http miniwebtool https://api.miniwebtool.com/v1/mcp \
  --header "Authorization: Bearer $MINIWEBTOOL_API_KEY"
```

Or add it to the MCP config file your client uses:

```json
{
  "mcpServers": {
    "miniwebtool": {
      "type": "http",
      "url": "https://api.miniwebtool.com/v1/mcp",
      "headers": { "Authorization": "Bearer ${MINIWEBTOOL_API_KEY}" }
    }
  }
}
```

Once connected, `tools/list` exposes `meta-tag-generator` with its JSON Schema, so you can
call it directly instead of writing an HTTP client.

## Credit budget — follow these exactly

This API is metered. A live call costs 1 credit; the free tier
includes 1,000 credits per month. Burning them during integration is the
single most common way to waste this key.

1. **Do all wiring against `/dry-run`, which costs 0 credits.** It validates the
   payload for real and returns a sample result with the exact response shape.
   Iterate there until your request builds and your parsing works.
2. **Make at most ONE live `/run` call** — a single end-to-end confirmation once
   dry-run passes. Print the result, then stop.
3. **Never call the API from unit tests, examples, or a retry loop.** Assert
   against the sample response captured from `/dry-run` instead.
4. **On 4xx, fix the payload — do not retry.** The error body is RFC 7807
   `application/problem+json` and says exactly what is wrong.
5. **On 429, honour `Retry-After`** and back off; do not tighten the loop.
6. **Read `X-MWT-Credits-Remaining`** on every response. If it drops below 50,
   stop making live calls and tell me.
7. If the integration needs repeated calls at runtime, **cache by input** — this
   tool is deterministic, so the same input always returns the same output.
how-to call meta-tag-generator
  1. Get an API key
    Get an API key. Sign up free for a bearer token. 1,000 credits/month, no card.
  2. Assemble the JSON body
    Required fields: . See the Request body table above for the full schema.
  3. POST to https://api.miniwebtool.com/v1/tools/meta-tag-generator/run
    Headers: Authorization: Bearer <key> and Content-Type: application/json. Copy-paste snippets in 7 languages are under Code examples.
  4. Parse the response
    Envelope: {request_id, tool, tool_version, credits_used, result}. The typed output lives in result.
faq frequently asked
What does the Meta Tag Generator API do?+

Build SEO, Open Graph, and Twitter Card meta tags with inherited defaults, length checks, and Google, Facebook, and Twitter preview data. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.

How much does one call to Meta Tag Generator cost?+

1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.

What parameters does the Meta Tag Generator API require?+

Required fields: (none). Full schema at /v1/openapi.json.

Is the Meta Tag Generator API deterministic?+

Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.

Can an AI agent call the Meta Tag Generator API?+

Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `meta-tag-generator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.

What format does the API return?+

JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.

mcp use from an AI agent

Every endpoint on this site is also exposed via the Model Context Protocol at https://api.miniwebtool.com/v1/mcp. Claude, Cursor, and any MCP-capable agent can discover this tool (meta-tag-generator) and its JSON Schema automatically — no client codegen.

# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="meta-tag-generator")'
see-also related webmaster tools