• DATA
  • GIT
  • STATUS
  • HUMAN

How to submit coverage reports with your AI

Connect Coveralls to your agent to automate your coverage reporting. Once linked, your AI handles the data transfer every time you run tests.

Ask AI about this page

Short answer

How can I send coverage data to Coveralls using my AI?

Your agent uses the submit_job tool to push coverage results and git metadata to Coveralls. This happens immediately after your test run completes, ensuring your dashboard stays current.

Where your data goes.

Coverage outcomes.

The agent moves data from your local environment to your Coveralls dashboard.

DATA

Updated coverage stats

The agent pushes your latest test results to Coveralls. You get an immediate update on your project's coverage percentage.

GIT

Synced git metadata

The agent sends commit and branch information alongside your reports. This keeps your coverage history tied to specific code changes.

STATUS

PR status updates

The agent ensures your pull requests reflect the latest coverage state. This helps you see if new code meets your requirements.

HUMAN

Manual review needed

The agent cannot fix coverage gaps or rewrite tests. You still need to look at the reports to decide which lines of code need more testing.

The workflow

What your AI does when the test run finishes.

The agent takes over the reporting task so you don't have to run manual upload commands.

  1. Capture results

    The agent identifies the coverage files and git metadata generated by your test runner.

    submit_job

  2. Format payload

    The agent organizes the coverage numbers and commit details into the format Coveralls expects.

    submit_job

  3. Execute upload

    The agent sends the completed data packet to the Coveralls API.

    submit_job

  4. Confirm success

    The agent verifies the submission was accepted and notifies you that the report is live.

    submit_job

Try it

Copy these to start.

Use these prompts to trigger a coverage submission.

Starting points

Replace the bracketed text with your specific repository or branch names.

Coveralls Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_4KFwfN2vWWEeowJibGZslVeROZZ50N2pFwaurAdx/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Coveralls capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "coveralls-code-coverage-analytics-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_4KFwfN2vWWEeowJibGZslVeROZZ50N2pFwaurAdx/mcp"
    }
  }
}
Copy into chat04

  • Submit the coverage report for the main branch in my current repo.

  • Send the latest test coverage data for the feature/login-fix branch to Coveralls.

  • Check if the coverage report for the current commit was successfully submitted.

  • Push the coverage results from my recent test run to Coveralls.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Coveralls once, then ask.

Link your account via the Vinkius dashboard. Once connected, your agent can trigger submissions whenever you ask.

Connect Coveralls to your AI

FAQ

Common questions

  • 01

    Can the AI change my coverage thresholds?

    No. The agent only submits data. You must manage your coverage rules and thresholds directly in your Coveralls settings.

  • 02

    Does the agent upload my entire source code?

    No. The agent only sends the coverage reports and the specific git metadata required for the submission.

  • 03

    Can I ask the AI to fix my low coverage?

    No. The agent can report the data, but it cannot write or modify your test files to increase coverage.

  • 04

    Will this work with any test runner?

    Yes, as long as your test runner produces a coverage report that the agent can find and send.

  • 05

    Does the agent handle multiple branches?

    Yes. You can tell the agent which specific branch or commit to report for using the submit_job tool.

  • More questions about Coveralls? The Connector page answers them. See everything the Coveralls Connector can do

Connect Coveralls to Claude, Cursor, ChatGPT & more