integrate-context-matic
Discovers and integrates third-party APIs using the context-matic MCP server. Uses `fetch_api` to find available API SDKs, `ask` for integration guidance, `model_search` and `endpoint_search` for SDK details. Use when the user asks to integrate a third-party API, add an API client, implement feature
By github · 1,133 installs
npx skills add github/awesome-copilot --skill integrate-context-matic
Source repository · Upstream listing
API Integration
When the user asks to integrate a third party API or implement anything involving an external API or SDK, follow this workflow. Do not rely on your own knowledge for available APIs or their capabilities — always use the context matic MCP server.
When to Apply
Apply this skill when the user:
Asks to integrate a third party API
Wants to add a client or SDK for an external service
Requests implementation that depends on an external API
Mentions a specific API (e.g. PayPal, Twilio) and implementation or integration
Workflow
1. Ensure Guidelines and Skills Exist
1a. Detect the Project's Primary Language
Before checking for guidelines or skills, identify the project's primary programming language by inspecting the workspace:
File / Pattern Language
.csproj , .sln csharp
package.json with "typescript" dep or .ts files typescript
requirements.txt , pyproject.toml , .py python
go.mod , .go go
pom.xml , build.gradle , .java java
Gemfile , .rb ruby
composer.json , .php php
Use the detected language in all subsequent steps wherever language is required.
1b. Check for Existing Guidelines and Skills
Check whether guidelines and skills have already been added for this project by looking for their presence in the workspace.
{language} conventions is the skill produced by add skills .
{language} security guidelines.md and {language} test guidelines.md are language specific guideline files produced by add guidelines .
update activity workflow.md is a workflow guideline file produced by add guidelines (it is not language specific).
Check these independently. Do not treat the presence of one set as proof that the other set already exists.
If any required guideline files for this project are missing: Call add guidelines .
If {language} conventions is missing for the project's language: Call add skills .
If all required guideline files and {language} conventions already exist: Skip this step and proceed to step 2.
2. Discover Available APIs
Call fetch api to find available APIs — always start here.
Always provide the language parameter using the language detected in step 1a.
Always provide the key parameter: pass the API name/key from the user's request (e.g. "paypal" , "twilio" ).
If the user did not provide an API name/key, ask them which API they want to integrate, then call fetch api with that value.
The tool returns only the matching API on an exact match, or the full API catalog (name, description, and key ) when there is no exact match.
Identify the API that matches the user's request based on the name and description.
Extract the correct key for the user's requested API before proceeding. This key will be used for all subsequent tool calls related to that API.
If the requested API is not in the list:
Inform the user that the API is not currently available in this plugin (context matic) and stop.
Request guidance from user on how to proceed with the API's integration.
3. Get Integration Guidance
Provide ask with: language , key (from step 2), and your query .
Break complex questions into smaller focused queries for best results:
"How do I authenticate?"
"How do I create a payment?"
"What are the rate limits?"
4. Look Up SDK Models and Endpoints (as needed)
These tools return definitions only — they do not call APIs or generate code.
model search — look up a model/object definition.
Provide: language , key , and an exact or partial case sensitive model name as query (e.g. availableBalance , TransactionId ).
endpoint search — look up an endpoint method's details.
Provide: language , key , and an exact or partial case sensitive method name as query (e.g. createUser , get account balance ).
5. Record Milestones
Call update activity (with the appropriate milestone ) whenever one of these is concretely reached in code or infrastructure — not merely mentioned or planned:
Milestone When to pass it
sdk setup SDK package is installed in the project (e.g. npm install , pip install , go get has run and succeeded).
auth configured API credentials are explicitly written into the project's runtime environment (e.g. present in a .env file, secrets manager, or config file) and referenced in actual code.
first call made First API call code written and executed
error encountered Developer reports a bug, error response, or failing call
error resolved Fix applied and API call confirmed working
Checklist
[ ] Project's primary language detected (step 1a)
[ ] add guidelines called if guideline files were missing, otherwise skipped
[ ] add skills called if {language} conventions was missing, otherwise skipped
[ ] fetch api called with correct language and key (API name)
[ ] Correct key identified for the requested API (or user informed if not found)
[ ] update activity called only when a milestone is concretely reached in code/infrastructure — never for questions, searches, or tool lookups
[ ] update activity called with the appropriate milestone at each integration milestone
[ ] ask used for integration guidance and code samples
[ ] model search / endpoint search used as needed for SDK details
[ ] Project compiles after each code modification
Notes
API not found : If an API is missing from fetch api , do not guess at SDK usage — inform the user that the API is not currently available in this plugin and stop.
update activity and fetch api : fetch api is API discovery, not integration — do not call update activity before it.