URL to Markdown SkillURL to Markdown Skill

OnlineCredit Usage:10 per callTool:URLtoMarkdownSkill

The tool

Let your agent read the web as Markdown. Call it as an MCP tool to fetch any page and return clean Markdown with headings, links and lists intact.

Once your client is connected to the VerveKit MCP server, this appears in its tool list as URLtoMarkdownSkill. It is read-only and open-world: it fetches, it never mutates anything on your side, so most clients will call it without asking you to confirm.

Tool call
{
  "name": "URLtoMarkdownSkill",
  "arguments": {
    "url": "https://www.example.com/article"
  }
}

What that looks like in a conversation

You don't name the tool — the model picks it. Asking about https://www.example.com/article in the terms this source covers is enough for it to reach for URLtoMarkdownSkill on its own.

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth — the client opens a browser once and there is no key to paste into a config file.

Client config
{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}
Endpoint
https://api.vervekit.com/v1/mcp

Per-client setup — Claude Desktop, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made.

ArgumentTypeExampleDescription
urlRequiredstringhttps://www.example.com/articleThe URL of the webpage to convert to Markdown
includeImagesPremiumbooleantrueWhether to include image references in the Markdown output
includeLinksPremiumbooleantrueWhether to include hyperlinks in the Markdown output

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client can read fields without parsing prose. status is "ok" on success and error is null; a null field means the value wasn't available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "url": "https://example.com/blog/getting-started",
    "title": "Getting Started Guide",
    "markdown": "# Getting Started Guide\n\nWelcome to our platform. This guide will help you get up and running quickly.\n\n## Prerequisites\n\nBefore you begin, make sure you have:\n\n- A registered account\n- API credentials\n- Node.js 18 or higher\n\n## Installation\n\nInstall the package using npm:\n\n```\nnpm install example-sdk\n```\n\n## Quick Start\n\nHere's a simple example to get you started:\n\n1. Import the SDK\n2. Initialize with your API key\n3. Make your first request\n\n## Next Steps\n\nCheck out our [documentation](https://example.com/docs) for more details.\n\n![Example Screenshot](https://example.com/images/screenshot.png)",
    "wordCount": 87,
    "imageCount": 1,
    "linkCount": 1
  }
}

Fields

FieldTypeExampleDescription
urlstringhttps://example.com/blog/getting-startedThe original URL that was converted
titlestringGetting Started GuidePage title extracted from the webpage
markdownstring# Getting Started Guide Welcome to our platform. This guide will help you get up and running quickly. ## Prerequisites Before you begin, make sure you have: - A registered account - API credentials - Node.js 18 or higher ## Installation Install the package using npm: ``` npm install example-sdk ``` ## Quick Start Here's a simple example to get you started: 1. Import the SDK 2. Initialize with your API key 3. Make your first request ## Next Steps Check out our [documentation](https://example.com/docs) for more details. ![Example Screenshot](https://example.com/images/screenshot.png)The converted Markdown content
wordCountnumber87Number of words in the extracted content
imageCountnumber1Number of images found in the content
linkCountnumber1Number of links found in the content

Failure modes

Errors come back as tool errors with a sentence the model can act on, not a bare status code.

StatusWhat it means
400 / 422The arguments didn't validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Out of credits. Not a bad key — the month's allowance is spent.
404This skill isn't part of VerveKit. Check the catalog.
429Brief rate limit. Retrying after a moment succeeds.

Other ways to use URL to Markdown Skill

Set up URL to Markdown Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an X-API-Key header, with SDKs for Node, Python and .NET.APIVerveReference →

Frequently asked questions

Do I have to tell the agent to use URLtoMarkdownSkill?

No. The tool's name and description are in the model's context once the server is connected, so it selects the tool when the question calls for it. Naming it explicitly works too and is useful when you want to force the call.

Does connecting the server expose every tool at once?

Yes — one connection lists the whole VerveKit catalog. Clients with a tool budget can usually filter the list; the credit cost is per call, so an unused tool costs nothing.

What does a call cost?

10 credits each time the tool actually runs. A model that reasons about the tool without calling it costs nothing.

Is there a REST version of this?

Yes — the same source is available as a plain HTTPS endpoint on APIVerve, linked above. Same data, same credits, same account.

What's Next?

Continue your journey with these recommended resources

Was this page helpful?